gtpg2m5fGeneral Macros

VCHKC-Check or Wait for Request to Be Completed

Use this general macro to wait for a virtual storage access method (VSAM) database support asynchronous macro (for example, the VGETC or VPNTC macro) to be completed. The VCHKC macro is necessary only if asynchronous processing is requested in the request parameter list (RPL).

Format




label
An optional label can be used with this macro.

addr
This parameter specifies the address of the RPL for this VCHKC macro request. You can specify the address in register notation (by using a register enclosed in parentheses) or by using an expression that generates an addressable data area.

Entry Requirements

Return Conditions

Programming Considerations

Examples

In the following example, return codes are checked after VCHKC macro processing is completed. Check the reason code field in the feedback area of the RPL for a detailed analysis of the errors. Errors such as RECORD NOT FOUND or END OF FILE are categorized as errors by VSAM database support.

  
  ·
  ·
  ·
VGENC BLK=ACB, Generate an ACB DDNAME=DDNAME, ..DDname MACRF=(KEY,DIR,IN) ..Options BNZ ERROR Process Errors LR R6,R14 Save ACB pointer in R6 VOPNC ACB=(R6) Open file BNZ ERROR Process Errors VGENC BLK=RPL, Generate an RPL AM=VSAM, ..Access method is VSAM ACB=(R6), ..ACB pointer in R6 LEVEL=D1 ..Use data level D1 VGETC RPL=(R7) Retrieve a record BNZ ERROR Process Errors VCHKC RPL=(R7) Wait for I/O completion BNZ ERROR Process Errors . . . DDNAME DC CL8'TRANSLOG' Data Definition Name