Previous Topic: Accessing the Retrieve Processing Options PanelNext Topic: Final Panel Processing


Panel Field Descriptions

Enter JOB Statements

Required. Length: 1-72. Type: character, uppercase.

Four lines allow you to change the JOB statements that CA-PanAPT uses for the generated Retrieve job stream. These lines are saved in the user's profile and used for future processing. You must supply at least the first JOB statement. Blank lines are ignored. These JOB statements are the same as those used by Verification Procedures.

Number of Members per Job

Optional. Length: 1-2. Type: numeric.

If you want to limit the number of members grouped together per job, specify the value here. If left blank, the default is 31 members per job. If you experience system 322 abends (too much CPU time) when retrieving multiple members, reducing this value can correct this.

From Lvl

Required. Length: 1-4. Type: alphabetic.

Specify the move level of the library the requested (from) member is to be copied from. Specify this as that level's short name, as defined to the Control file. Only levels used by the member's Library Code can be chosen. This field is filled in for you automatically. CA-PanAPT searches from the Development Test level up through your highest migration level looking for the member and supplies the first level that it finds for the member. If the member is not found, the level is blank, and the Checkout From Type value is ADD.

If CA-PanAPT cannot search for the member because its access method does not have a browse exit defined, the highest active level defined to the Library Code is filled in. A blinking asterisk appears to the right of the level to indicate this.

From Type

Optional. Type: alphabetic.

This field is used to specify that the member is to be copied from the From Lvl's Backup or Backout library, instead of its primary library. A value of BKUP, BU, or U indicates that the Back Up library is the origin of the Retrieve. A value of BKOT, BO, or O indicates that the Back Out library is the origin. If left blank, the primary library is used. You cannot choose a Back Out library for a level that does not support Back Out, and you cannot choose a Back Up library for a level that does not have Back Up enabled.

You can also specify a value of ADD indicating that you are adding a new member. When you specify ADD, the From Lvl field must be blank. Only specify ADD if your Retrieve models support it. They must add a prototype member to the test library. The distributed PDS, CA-Panvalet, and CA-Librarian Retrieve models all support this.

From Member

Display only. This field displays the name of the requested member to be used for the Copy utility. The name is the same as the member that was successfully Assigned. You cannot modify this field.

From Data

Optional. Length: 1-8. Type: alphanumeric or blank.

There are eight characters to pass data to the Retrieve Model. You can access the value of this field through the $FROMDATA System Model variable. The default value is null (" ").

To Member

Optional. Length: 1-10. Type: alphanumeric.

This field contains the name of the copied member in the starting level test library. This field defaults to the From Member value, but you can modify it to any other name. The To Member must not exist already in the starting level library unless the Replace Member option (see below) is also selected. If it exists already and you specify N for the Replace Member option, the Retrieve Job fails. The name specified as the To Member must be a valid length, as specified in the Library Code under Member Name Lengths Allowed.

To Data

Optional. Length: 1-8. Type: alphanumeric.

There are eight characters to pass data to the Retrieve Model. You can access the value of this field through the $TODATA System Model variable. The default value is null (" ").

Replace Member

Required. Length: 1. Type: alphabetic. Valid values: Y (Yes) or N (No).

This field determines if an existing member on the starting level test library that has the To Member name should be overwritten (replaced). Enter a value of Y to allow replacement. Enter a value of N to prevent replacement. The default value is N.

Important! Any Retrieve Model that implements the Replace Member option by a DELETE of the member from the starting level library, or a COPY (ADD) of the member to the starting level library, runs the risk of destroying the member in the event that the From Library does not already contain the member.

Library Code

Display only. Length: 1-7. Type: alphanumeric.

This field displays the Library Code associated with the member.