Modeling Facility › Sample Models › Miscellaneous Development Facility and Retrieve Models › Reporting the Status of a Retrieve

Reporting the Status of a Retrieve

Model name: APJCMSGS

Usage: Retrieve Processing.

Purpose: Generate JCL to report the status of a Retrieve based on return codes.

User keywords passed to the model:

EMLT

Set before invoking the model in the Retrieve Model Specifications of the Library Code definition or in a preceding model. The values of EMLT and $MEMBERCOUNT are used to generate a step name in a COND test.

For example, model APJCPDS is distributed with a stepname PDS. APJCPDS sets EMLT to PDS. Therefore, the following Retrieve Model Specification sends status messages back to the user who is Retrieving a member:

INC APJCPDS; INC APJCMSGS

CERTAIN

Set before invoking the model by the preceding Retrieve model. If CERTAIN=Y, it indicates that a return code of zero from the step named by EMLT guarantees that the Retrieve was successful.

If CERTAIN=N, it indicates that a return code of zero is not conclusive. In particular, IEBCOPY returns zero if the member was not copied because replace was not allowed.

Output: JCL and control statements to send messages to users. The program issues a TPUT to the user's user ID.

Processing Overview: APJCSEND is similar to APJCMSGS in function. APJCMSGS is faster, but does NOT deliver messages to the submitting user unless the user stays logged on.