SIMDATE Date Simulation for the AS/400

	Home
	Fact Sheet
	Benefits
	FAQ
	Download
		Installation Instructions
		License Agreement
	Product Documentation
	Partners and Links
	Contact Us

Product Documentation

SIMDATE (Simulate Date Facility) Command

                    --*STS--
>>--SIMDATE--SET(--|--*ON---|--)------------------------------------------------------------>
                   |--*CHG--|
                   |--*OFF--|
                   |--*KEY--|
>---- ------------------------------------------------------------------------------ ------->
     |--USEDATE(--absolute-date-to-be-used--)-----(1)-------------------------------|
     |--RELDATE(--relative-year-----relative-month-----relative-day--)-----(1)------|
 

>---- --------------------------- ---------------------------------------------------------->
     |           |--*YES--|      |
     |--CHGJOB(--|--*NO---|--)---|     (2)
 

>---- ------------------------------ ------ ----------------------------- ------------------><
     |              |--*YES--|      |      |             |--*YES--|      |
     |--PROPAGATE(--|--*NO---|--)---|      |--RELATIVE(--|--*NO---|--)---|

Notes:

All parameters can be specified in positional form.

(1) Either USEDATE or RELDATE (but not both) must be specified when SET(*ON) or SET(*CHG) is specified.
If SET(*STS), SET(*KEY) or SET(*OFF) is specified, neither USEDATE nor RELDATE may be specified.

(2) CHGJOB may be specified only with SET(*ON), SET(*OFF), or SET(*CHG).

(3) PROPAGATE and RELATIVE may be specified only with SET(*ON) or SET(*CHG).

Purpose

The Simulate Date Facility (SIMDATE) command provides a command interface to all features of the SIMDATE Date Intercept Facility. SIMDATE allows a user to specify that a particular date should be returned in place of the current date to those programs requesting the current date. This requests affects only the job in which SIMDATE is executed. The system clock is unaffected.

Parameters

SET
Specifies the action requested of the SIMDATE Date Intercept Facility. Possible values are:

*STS: Displays a panel indicating the current status of the SIMDATE Date Intercept Facility and, if active, what date will be returned in place of the current date. The panel also displays the status of other internal SIMDATE data items. To receive this information into a CL program, see the RTVSIMDATE command.
*ON: Enables the SIMDATE Date Intercept Facility. The date to use is specified either in the USEDATE parameter or the RELDATE parameter. Future requests for the current date will return the specified date in place of the current system date.
*OFF: Disables the SIMDATE Date Intercept Facility. The system behaves as though the SIMDATE product was not installed.
*CHG: Changes the date which the currently activated SIMDATE Date Intercept Facility will return. The date to use is specified either in the USEDATE parameter or the RELDATE parameter. This option requires that SIMDATE *ON have been previously executed.
*KEY: Invokes the security key management portion of the SIMDATE Date Interface Utility allowing full use of the product if it is licensed during or after the trial period.

USEDATE
Specifies the date to return in place of the current date for this activation of SIMDATE. The date is specified in the current job date format.

absolute-date-to-be-used: This is the date to return in place of the current date. It must be in format of the current job date.

Note: If SET(*ON) or SET(*CHG) is specified, either this parameter or the RELDATE parameter must be specified. If SET(*STS), SET(*OFF), or SET(*KEY) is specified, this parameter may not be specified.

RELDATE
Specifies the adjustments to apply to the current date to determine the date to return in place of the current date for this activation of SIMDATE. The adjustments can be in the form of positive or negative numbers for the current year, month, and day. For example, RELDATE(3 0 0) would return a date three years from today as the current date. Please note that the increments are added to the date in the following order: year, month, day. This parameter consists of three elements:

Element 1: relative-year

This is a positive or negative number to add to the current year when determining the date which SIMDATE is to return in place of the current date.

Element 2: relative-month

This is a positive or negative number to add to the current month when determining the date which SIMDATE is to return in place of the current date.

Element 3: relative-day

This is a positive or negative number to add to the current day when determining the date which SIMDATE is to return in place of the current date.

Note: If SET(*ON) or SET(*CHG) is specified, either this parameter or the USEDATE parameter must be specified. If SET(*STS), SET(*OFF), or SET(*KEY) is specified, this parameter may not be specified.

CHGJOB
Specifies whether or not the job date is changed (in addition to the current date) for this SET(*ON) or SET(*CHG) request.

*YES: Changes the job date in addition to the system date. The original job date will be restored when SIMDATE *OFF is executed.
*NO: The job date remains unchanged.

PROPAGATE
Specifies whether or not jobs submitted from this job will inherit the SIMDATE settings from this job. Possible values are:

*YES: Any job submitted from this job by the SBMJOB command will inherit the SIMDATE settings from this job as if those settings were specified at the beginning of the submitted job. If the RTGDTA parameter is used on the SBMJOB command, it must specify a program which will properly interpret a CALL command placed as the last entry in the submitted job's message queue.
*NO: Any job submitted from this job by the SBMJOB command will behave as if SIMDATE was not in effect for the submitting job.

RELATIVE
Specifies whether or not the SIMDATE date will change if the system date changes while this job is under SIMDATE control. Possible values are:

*YES: The SIMDATE date will change if the system date changes while this job is under SIMDATE control. In other words, if this job runs past midnight, the SIMDATE will also change.
*NO: The SIMDATE date will not change if the system date changes while this job is under SIMDATE control. The date computed now will be used for this job even if this job runs past midnight.

Examples

Example 1: Enabling SIMDATE

     SIMDATE SET(*ON) USEDATE('11/14/2056')

This command enables SIMDATE, if it is not already enabled, and directs that November 14, 2056 be returned as the current date when requested by a program. Please note that, if you are using the trial version, this request will be denied since it is after December 31, 1999. Instead try:

SIMDATE SET(*ON) USEDATE('11/14/1956')

Example 2: Disabling SIMDATE

     SIMDATE SET(*OFF)

This command disables SIMDATE and causes the job to act as if SIMDATE was not installed. The current date is returned for all program date requests.

Example 3: Determining the status of SIMDATE

     SIMDATE SET(*STS)
-or- SIMDATE

This command causes SIMDATE to display a panel indicating the current intercept status and other information.

For more information, please see our fact sheet and our list of benefits. If these don't answer your questions, check out our FAQ or email us. Of course, you can always call us at 1-323-658-1146.