Normally, SIMULATE 2000 will only intercept time requests from application programs. Occasionally, an operating system program runs in an application key. The DEFLIST rules statement allows you to specify program names that should be skipped by SIMULATE 2000 processing. To use DEFLIST, simply list the programs to exclude in inside the parentheses. Note: the program names can use the masking facilities.
DEFLIST PGMLIST (IDCAMS) TYPE(XPGM)
DEFLIST can also be used skip SIMULATE 2000 processing for specific types of clock requests made by the list of programs: SVC11, TIMEPC, TIMEPCCM and the DYNAMOD type calls (FETCH). These requests are skipped using the XSVC11, XTIMEPC, XFETCH and XTIMEPCCM options on the TYPE parameter.
Lastly, the DEFLIST statement can be used to force a STCK modified clock to be returned as a GMT value - no local offset is applied to the clock. The TYPE(GMTPGM) parameter only applies to SVC 11 STCK format requests or STCK instructions intercepted by the Dynamod option.
DEFLIST name
( pgm1, pgm2,... )
TYPE( option )
name
Function: This is a required parameter. The name parameter identifies
the list being defined by the DEFLIST statement. For SIMULATE 2000, the name field is required, but the specified name is user selectable.
Default: None
Format: Specify a name 1 to 20 characters long.
( pgms )
Function: This is a required parameter. The pgms parameter lists the
program names that will be excluded from SIMULATE 2000 processing. Note: this facility is normally required only in multi-tasking environments like TSO.
Default: None
Format: The program names must be placed within parentheses, even if
only one program name is listed. The entries should be separated by commans or blanks. If continuation is required, omit the right parenthesis,and continue the list on the following line. The right parenthesis will terminate the program name list.
TYPE( option )
Function: This is a required parameter. Normally, SIMULATE 2000 will
only intercept time requests from application programs. Occasionally, an operating system program runs in an application key. The DEFLIST rules statement allows you to specify program names that should be skipped by SIMULATE 2000 processing. To use DEFLIST, simply list the programs to exclude in inside the parentheses. Note: the program names can use the masking facilities.
DEFLIST PGMLIST (IDCAMS) TYPE(EXECPGM) DEFLIST PGMLIST (IDCAMS,ISRUDL) TYPE(CDEPGM)
To skip SIMULATE 2000 processing on the specified programs, the TYPE parameter can be set to EXECPGM, CDEPGM or XPGM. EXECPGM is the name of the program obtained from the EXEC state-ment in your JCL. For TSO environments, this name is always IKJEFT01. The CDEPGM name is the name of the program obtained from the current CDE, which is created when program issues an ATTACH or LINK request. This field contains the name of the current TSO command. If you don’t care about the program type, the TYPE(XPGM) parameter can be used generically skip programs like IDCAMS in the example below. Note: The XPGM option will also examine the TRAN_PGM name for the exclude comparison.
DEFLIST PGMLIST (IDCAMS) TYPE(XPGM)
There are also conditions where you might want to force SIMULATE 2000 to skip processing based on the type of clock request. The TYPE parameter for this type of exclude are XSVC11, XTIMEPC, XFETCH and XTIMEPCCM. As an example, the following DEFLIST and DEFLMOD statements can be used to skip SVC 11 processing for pro-grams using the IBM C++ time requests. The DEFLMOD statement allows the Dynamod option to intercept the STCK instruction in the C++ runtime library. The SVC 11 used in the same program requires a “normal” clock value to correctly calculate the local time for applica-tions making a clock request. Note: this has no affect on programs using LE.
DEFLIST PGMLIST (CEEEV003) TYPE(XSVC11) DEFLMOD PGMLIST (CEEEV003) SCANFOR(STCK NOCVT) NOCHECK
Lastly, the TYPE(GMTPGM) parameter can be used to force a STCK modified clock to be returned as a GMT value - no local offset is applied to the clock. The TYPE(GMTPGM) parameter only applies to SVC 11 STCK format requests or STCK instructions intercepted by the Dyna-
mod option. This option is usually used when the application program applies the local offset to the returned STCK value.
Default: None
Format: CDEPGM, EXECPGM, GMTPGM, XFETCH, XPGM,
XSVC11, XTIMEPC, or XTIMEPCCM