Sterling Gentran:Server for UNIX Purge Process Service

The Sterling Gentran:Server® for UNIX Purge Process service deletes lifecycle records created before a date and time designated by you.

The following table provides an overview of the Sterling Gentran:Server for UNIX Purge Process service:

System name None
Graphical Process Modeler (GPM) category None
Description Deletes lifecycle records created before a date and time designated by you.
Preconfigured? No
Requires third-party files? LC221 and LCDESTINFO tables created in Sterling Gentran:Server
Platform availability Platform availability:
  • Sun Solaris
  • HP-UX
  • IBM-AIX
Related services No
Application requirements Sterling Gentran:Server for UNIX
Initiates business processes? No
Invocation Runs by the Sterling B2B Integrator scheduler.
Business process context considerations No

How the Sterling Gentran:Server for UNIX Purge Process Service Works

The Sterling Gentran:Server for UNIX Purge Process service deletes records from the LIFECYCLE and LIFECYCLE_EXTENSION tables created in Sterling B2B Integrator and from existing LC221 and LCDESTINFO tables created in Sterling Gentran:Server. The service runs as a step in a business process or by itself on a schedule.

For example, consider the following scenario. Today is August 12, 2004 and the time is 3 p.m. You want to delete files older than three days and five hours. Using this service, you can delete files created before August 9, 2004 at 10 a.m.

Implementing the for Sterling Gentran:Server for Unix Purge Process Service

To implement the Sterling Gentran:Server for UNIX Purge Process service for use in a business process, complete the following tasks:
  1. Create a Sterling Gentran:Server for UNIX Purge Process service configuration. See Creating a Service Configuration.
  2. Configure the Sterling Gentran:Server for UNIX Purge Process service. See Configuring the Sterling Gentran:Server for UNIX Purge Process Service.
  3. Use the Sterling Gentran:Server for Unix Purge Process service in a business process.

Configuring the Sterling Gentran:Server for UNIX Purge Process Service

To configure the Sterling Gentran:Server is for UNIX Purge Process service, you must specify settings for the following fields in Sterling B2B Integrator:

Note: The names in parentheses represent the corresponding field names in the GPM. This information is provided for your reference.
Field Description
Name Unique and meaningful name for the service configuration. Required.
Description Meaningful description for the service configuration, for reference purposes. Required.
Select a Group Select one of the options:
  • None – You do not want to include this configuration in a group at this time.
  • Create New Group – You can enter a name for a new group in this field, which will then be created along with this configuration.
  • Select Group – If you have already created one or more groups for this service type, they are displayed in the list. Select a group from the list.
Note: See Using Service Groups.
Run As User Applies to the scheduling of the business process. The Run As User field only displays as an option if Start a business process once files are collected is set to Yes. Type the user ID to associate with the schedule, or click the icon and select a user ID from the list. Valid values: Any valid Sterling B2B Integrator user ID.
Note: This parameter allows someone who doesn't have rights to a specific business process to run it. If you select Admin as the user ID, you will inherit Administrative rights (for this run of the business process only), and enable the scheduled run.
Use 24 Hour Clock Display If selected, the adapter will use the 24-hour clock instead of the default 12-hour clock.
Schedule Information about scheduling the business process after the File System adapter collects files. The Schedule field only displays as an option if Start a business process once files are collected is set to Yes. Valid values:
  • Do not use schedule If you select this field, the adapter does not start a business process and does not run on a schedule.
  • Run based on timer Valid values are the hour and minutes at which to run the adapter. If you choose to select a time interval, the valid values are the hours and minutes for the intervals. Add or delete selections as necessary. Specify any schedule exclusions or date exclusions. Indicate whether you want the adapter to run at startup.
  • Run daily Valid values are the hour and minutes at which to run the adapter, daily. If you choose to select a time interval, the valid values are the hour and minute for the interval. Add or delete selections as necessary. Specify any date exclusions. Indicate whether you want the adapter to run at startup.
  • Run based on days of the week Valid values are the day of the week, the hour, and the minute that specify when to run the adapter. If you choose to select a time interval, the valid values are the hours and minutes for the intervals. Add or delete selections as necessary. Specify any date exclusions.
  • Run based on days of the month Valid values are the day of the month, hour, and minute that specify when to run the adapter. If you choose to select a time interval, the valid values are the hours and minutes for the intervals. Add or delete selections as necessary. Specify any date exclusions.
Lifespan Days (lifespandays) Number of days from the current day used to determine which records to delete from the LIFECYCLE, LIFECYCLE_EXTENSION, LC221, and LCDESTINFO tables. Optional.
Lifespan Hours (lifespanhours) Number of hours from the current time used to determine which records to delete from the LIFECYCLE, LIFECYCLE_EXTENSION, LC221, and LCDESTINFO tables. Optional.
Business Process (initialWorkFlowName) Business process where the records are located. Optional.