The system keywords described below have no value until they are assigned a value by Keyword Assignment Statements in your model. These resettable system keywords let you control the modeling facility directly. Note that not all of the keywords are supported in every modeling facility, check the table under System Keywords Availability later in this chapter.
Specifies an alternate Library Code to access. When you set this keyword, the other Library Codes values are accessible using the $ALT and $LVLALT prefixed keywords. Until this is specified, all the $ALT and $LVLALTLIBC keywords are null. Also if the Library Codes specified do not exist, all of the $ALT and $LVLALTLIBC prefixed keywords including this one are nullified.
This keyword must be specified in the same format as $LIBCFORM, a seven-character Library Code and Subcode formatted with a slash (xxxx/yyy). However, strict adherence is not necessary. Embedded spaces are stripped. If there is no Subcode, the slash is optional. Be aware that the value of this keyword is immediately reformatted. For instance, if you set it to xx / y it is reformatted to xx/y.
Specifies or resets model statement delimiters. Specify model statement delimiters with an assignment statement, such as $DELIM = 'wxyz'. Resetting model statement delimiters by coding $DELIM = RESET is equivalent to coding an assignment statement, such as $DELIM = '@<>!'. See Delimiters earlier in this chapter.
Specifies that External Processing is required for the member being modeled. Set this keyword to a value of YES during the MOVE phase with an assignment statement, such as $EXTERNAL = 'YES'. Any other value besides YES is invalid. If you do not set the value to YES, then no External Processing is expected for the member being modeled.
External processing requires you to execute APCS5391 to post the completion of processing done outside APJJ5320. For details on External Processing, see the "Setups for Different Types of Moves" chapter in the CA‑PanAPT Reference Guide.
Specifies the level associated with the $LVL prefixed scrollable keywords. You must set this keyword to the short name of the level to change the level positioning of the scrollable values. Until you set this, all of the scrollable keywords are null. If you set this to a non‑existent level name, CA‑PanAPT changes the value of the $LEVEL keyword and all of the scrollable keywords to null.
For example, to access the data set name of the production library for the current Library Code, set $LEVEL to 'PROD' (or whatever the short name for production is), and access the $LVLLIBCDESTDSN scrollable variable.
Flushes the remaining members of the current Library Code from the modeling process. Set this keyword to a value of Y at any time with an assignment statement such as, $LIBCODEFLUSH = 'Y'.
The model statements following the assignment of this keyword are processed, however, no further processing is done for the active Library Code. When this keyword is assigned during an INIT or MOVE phase, no subsequent MOVE phases or TERM phase is provided for the Library Code.
Provides a 1 to 55-character message to the modeling facility. Online modeling facilities, such as Retrieve and Verification modeling, display the message on the user's terminal. Batch modeling facilities print the message on reports.
The message is not displayed unless a non-zero value is assigned to the system keyword $RC.
Specifies the ddname of the file where modeling output records are written. Set this keyword to a value identifying any currently allocated sequential file or APTMDLO. When available, this keyword must be assigned before any modeling output records can be generated.
The ddname value assigned to this keyword can identify a sequential data set. You cannot subsequently assign a value to the $OUTMEM system keyword after assigning $OUTDD to a sequential data set. Allocate the data set with DISP=MOD because it is opened and closed multiple times. The ddname must identify a real sequential data set, it cannot be DUMMY or NULLFILE.
When the value APTMDLO is assigned to this keyword, modeling output is directed to the standard output library. The system keyword $OUTMEM must then be assigned before any modeling output records can be generated. A new member is created in the APTMDLO library, or an existing member is extended. APTMDLO is the ddname of the standard output PDS data set.
Whenever the value of $OUTDD is changed, the system keywords $OUTMEM and $OUTPOST are reset to blanks. Be careful when assigning $OUTDD to APTMDLO after having previously assigned it to a sequential file. The system keyword $OUTMEM will not have its previous value. In addition, $OUTPOST must be assigned a value for posting records to be properly generated.
Specifies the 1 to 8-character name of the member where modeling output statements are directed when $OUTDD is set to APTMDLO.
This keyword must be assigned after assigning $OUTDD with a value of APTMDLO and before any modeling output statements are generated. This keyword cannot be assigned unless $OUTDD has a value of APTMDLO.
The value of this keyword is reset to blanks whenever the value of $OUTDD is changed and at the start of each modeling phase (such as INIT, MOVE, and TERM).
A unique prefix is needed for each group's use to prevent different groups of members that are being moved (see the topic Model Processing earlier in this chapter for information about groups) from inadvertently constructing JCL and control statements into the same members on the APTMDLO data set. A common naming scheme is needed for this, and adherence to this by your models is required for this to work. This is the purpose of the $OUTPFX variable. It is initialized to a generated prefix that is unique for each group. Typically models use this keyword when the $OUTMEM keyword is specified.
For example, a model that generates a main JCL member and two control statement members referenced by the JCL sets $OUTMEM as following:
<$OUTPFX> for the main JCL member,
<$OUTPFX>A for the first control statement member, and
<$OUTPFX>B for the second control statement member.
$OUTPFX is initialized by modeling as follows:
This gives you a unique seven‑character prefix, giving you a single character to use as a suffix. It also lets you easily identify to which group the members of APTMDLO pertain.
If this does not suit your needs, you can alter the $OUTPFX value. It must be 1 to 7 characters long and adhere to the rules for a valid PDS member name (position 1 contains uppercase alphabetic or national characters, the remaining characters contain uppercase alphabetic, national, or numeric characters). If you modify this for Move Modeling, the APJMLEAD module is an ideal place to do this, for you can be assured this is set before any of your Library Code Model specifications.
Note: The $OUTPFX variable is only available during the INIT, MOVE, and TERM phases of modeling.
Specifies the 1 to 7-character name of the PDS member where additional posting records are written. A # (pound) is automatically suffixed to the value assigned. The value you assign cannot contain a # character.
The Move Modeling Facility always generates two posting records for each member modeled. The first is written to member INITMEM# of PDS APTMDLO. You direct the second posting record to another member by assigning a value to this keyword. If a value has not been assigned to this keyword by the end of the modeling process for a member, then the second posting record is written to a member whose name is derived from the value of $OUTPFX with the # character suffix.
The value of this keyword is reset to blanks whenever the value of $OUTDD is changed, and at the start of each modeling phase (for example, INIT, MOVE, and TERM).
Specifies a four-digit Return Code. Set this keyword to any value in the range 0000 through 4096 with an assignment statement, such as $RC = '0008'. The highest value assigned during the modeling process is used to set the return code for the modeling facility.
Online modeling facilities, such as Retrieve and Verification modeling, cancel the modeling process when the return code is set to a value greater than zero. Batch modeling facilities, such as Move and On-Demand modeling, might be sensitive to specific return code values. JCL specifications in the standard Move Job (APJJ5320) cause the Move Job to terminate when $RC is assigned a value greater than 7, for instance.
|
Copyright © 2004 CA.
All rights reserved.
|
|