Previous Topic: Reporting the Status of a RetrieveNext Topic: Retrieve Models


Sending Messages During Retrieve

Model Name: APJCSEND

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 SEND commands for IKJEFT01.

Processing Overview: APJCSEND is similar to APJCMSGS in function. APJCSEND is slower, but delivers messages to the submitting user even after logoff.