Model name: APJMEXTR
Usage: Daily Processing Cycle. Development Facility.
Purpose: Extract a source member from a concatenation of libraries to a sequential data set for a compile or link edit.
User keywords passed to the model:
APJMEXTR_INCLIST—This keyword contains the list of Library Codes used to determine the data sets to be included for CA Panvalet ++INCLUDE or CA‑Librarian -INC statement expansion. This keyword can be set to one of the related Library Code keywords, such as $RELCOMPINC or $RELLKEDINC, and it can also be manually constructed.
Each Library Code name in the list must be formatted suitable for $ALTLIBCFORM to be set to it. Each Library Code name in the list must be padded on the right with spaces to occupy 9 positions if other Library Codes follow them. That is, if you specified four Library Codes, the first would start at position 1, the second at position 10, the third at position 19, and the fourth at position 28. You can specify as many as 8 Library Codes in the list.
For CA‑Panvalet data sets, take care that the result does not cause more than 10 data sets to be included because CA‑Panvalet cannot concatenate more than that.
APJMINCP_DSNnn—These keywords let you define additional CA Panvalet data sets for extracting ++INCLUDE members. These data sets follow any data sets generated on behalf of the APJMEXTR_INCLIST keyword.
A list must be created using these keywords. The first data set in the list must be specified in keyword APJMINCP_DSN01, the second in APJMINCP_DSN02, and so forth. The total number of data sets must be specified as a two‑digit integer in keyword APJMINCP_DSN00. For example, if the last data set was specified in keyword APJMINCP_DSN07, set APJMINCP_DSN00 to '07'.
APJMINCL_DSNnn—These keywords let you define additional CA‑Librarian data sets for extracting -INC members. These data sets follow any data sets generated on behalf of the APJMEXTR_INCLIST keyword.
A list must be created using these keywords. The first data set in the list must be specified in keyword APJMINCL_DSN01, the second in APJMINCL_DSN02, and so forth. The total number of data sets must be specified as a two‑digit integer in keyword APJMINCL_DSN00. For example, if the last data set was specified in keyword APJMINCL_DSN07, set APJMINCL_DSN00 to '07'.
SIMPLE_LINK—This keyword informs the model whether it is extracting the member being processed by modeling or its related link stream member. A value of 0 means the link stream defined to the members Inventory is being extracted. If the keyword is not defined or if it has any other value, then the member being processed by modeling is to be extracted. This keyword must be set by the invoking compile/link model.
PANEXEC—This keyword indicates if the extract has to run under CA‑Panexec. A value of 1 indicates to run the extract under CA‑Panexec and generate any DD statements required. A value of 2 indicates to run the extract under CA‑Panexec and generate the PANEIN control statements that run the extract. If the keyword is not defined or the value is blank, this indicates to not run the extract under CA‑Panexec. Any other value is invalid and causes incorrect JCL to be generated. This keyword must be set by the invoking compile/link model.
$L$LIBR_PGM—If the member is to be extracted from CA‑Librarian, this keyword indicates the name of the CA‑Librarian program name, which is usually AFOLIBR. This keyword should be set in the APJMLEAD model.
NUMCONDS—This two‑digit integer should contain the suffix of the most recently added CONDnn keyword that is used for the APJMCOND condition code statement model. If there are no CONDnn keywords set yet, NUMCONDS should contain 00.
CONDnn—If there were any steps preceding the extract that must run successfully for the extract to run, there must be a CONDnn keyword set for each step. See the APJMCOND condition code statement model for details.
$G$JCLLIST—This keyword controls the SYSOUT class for the JCL listings. It is set in the APJMLEAD model.
$G$SYSTEMP—This keyword specifies the OS/390 unit for work files. It is set in the APJMLEAD model.
User keywords returned from the model:
APJMEXTR_SOURCE_DD—This keyword returns to you the DD name of the sequential data set to which the source is extracted.
NUMCONDS—This keyword is incremented to reflect the additional CONDnn statements added for testing if all steps were successful so far. This keyword is not incremented if the extract is run under CA‑Panexec.
CONDnn—Additional CONDnn keywords are created for testing if all steps were successful so far. This keyword is not incremented if the extract is run under CA Panexec. Refer to the APJMCOND model for details on CONDnn keywords.
Processing Overview:
The means by which the source is extracted varies, depending on the Access Method (CA‑Panvalet, CA‑Librarian, or PDS) and if it is being extracted under CA‑Panexec.
|
Copyright © 2004 CA.
All rights reserved.
|
|