Retrieve Processing › Types of Retrieve Processing › Online Retrieve Processing

Online Retrieve Processing

You can access Retrieve processing explicitly through the Inventory File Maintenance ‑ Entry panel, APIP600, action of RET (Assign and Retrieve).

You can access Retrieve processing implicitly through the Move Request Maintenance panel, APIP100, actions of ADD and CHG (change), if the Library Code has Auto Assignment and Auto Retrieve enabled. When you process with this option, CA-PanAPT displays the Retrieve Pro\-cessing Option panel, APIP710, to let you specify the Retrieve options on an individual member basis.

You can select the following Retrieve options:

• The move level from which the member is to be copied (for example, QA or PROD).
• Whether to copy the member from the primary, Back Up, or Back Out library.
• The name of the member when it is copied to the starting test library.

  Whether CA-PanAPT should overwrite a member if it already exists in the starting test library.

You can also override the jobcard specifications that are used for the batch execution of the copy utilities.

After CA-PanAPT collects your Retrieve specifications, it generates a Retr\-ieve (batch) job stream online through foreground execution of the CA-PanAPT Modeling facility. A Retrieve Model generates the appropriate copy utility JCL and control statements for an individual member. A Retrieve job stream structure contains:

• A jobcard generated from the Job Statement fields of the Retrieve Processing Options panel, APIP710.
• An appropriate copy utility STEP for each member generated by the associated Retrieve model.
• An Optional NOTIFY message utility that follows the copy utility STEP used to report the success or failure of Retrieve processing on an individual member basis.

The Modeling processing output is written to the Internal Reader or sub\-mitted through TSO services depending on the system Control File specification.

OS/390has a 255-step limit for each job submitted. This limits the number of members you Retrieve in a single job. CA‑PanAPT breaks your Retrieves into multiple jobs if enough members are Retrieved, to avoid 255 job steps. This is based on the number of steps in the Retrieve models distributed by CA‑PanAPT. Your own models might have more steps, allowing for fewer Retrieves in a job. If this turns out to be the case, you can change the number of Retrieves that are grouped together by having your systems administrator adjust the value of the CHKOLMT variable in panel APIP710.