Specifying the AIB mask for ODBA applications

The notes that follow describe the contents of each field.

AIB Identifier (AIBID)

This 8-byte field contains the AIB identifier. You must initialize AIBID in your application program to the value DFSAIBbb before you issue DL/I calls. This field is required. When the call is completed, the information returned in this field is unchanged.

DFSAIB Allocated Length (AIBLEN)

This field contains the actual 4-byte length of the AIB as defined by your program. You must initialize AIBLEN in your application program before you issue DL/I calls. The minimum length required is 264 bytes for ODBA. When the call is completed, the information returned in this field is unchanged. This field is required.

Subfunction Code (AIBSFUNC)

This 8-byte field contains the subfunction code for those calls that use a subfunction. You must initialize AIBSFUNC in your application program before you issue DL/I calls. When the call is completed, the information returned in this field is unchanged.

Resource Name (AIBRSNM1) #1

This 8-byte field contains the name of a resource. The resource varies depending on the call. You must initialize AIBRSNM1 in your application program before you issue DL/I calls. When the call is complete, the information returned in this field is unchanged. This field is required.

For PCB related calls where the AIB is used to pass the PCB name instead of passing the PCB address in the call list, this field contains the PCB name. The PCB name for the I/O PCB is IOPCBbb. The PCB name for other types of PCBs is defined in the PCBNAME= parameter in PSBGEN.

Resource Name (AIBRSNM2) #2

Specify a 4-character ID of ODBA startup table DFSxxxx0, where xxxx is a 4-character ID.

Reserved 1

This 8-byte field is reserved.

Maximum Output Area Length (AIBOALEN)

This 4-byte field contains the length of the output area in bytes that was specified in the call list. You must initialize AIBOALEN in your application program for all calls that return data to the output area. When the call is completed, the information returned in this area is unchanged.

Used Output Area Length (AIBOAUSE)

This 4-byte field contains the length of the data returned by IMS for all calls that return data to the output area. When the call is completed this field contains the length of the I/O area used for this call.

Reserved 2

This 12-byte field is reserved.

Return code (AIBRETRN)

When the call is completed, this 4-byte field contains the return code.

Reason Code (AIBREASN)

When the call is completed, this 4-byte field contains the reason code.

Error Code Extension (AIBERRXT)

This 4-byte field contains additional error information depending on the return code in AIBRETRN and the reason code in AIBREASN.

Resource Address (AIBRSA1) #1

When the call is completed, this 4-byte field contains call-specific information. For PCB related calls where the AIB is used to pass the PCB name instead of passing the PCB address in the call list, this field returns the PCB address.

Resource Address (AIBRSA2) #2

This 4-byte field is reserved for ODBA.

Resource Address (AIBRSA3) #3

This 4-byte token, returned on the APSB call, is required for subsequent DLI calls and the DPSB call related to this thread.

AIB return token (AIBRTKN)

AIB return token. This 8-byte field contains a token returned by a DL/I call. The usage is specific to the DL/I call for which the token was returned.

Reserved 3

This 32-byte field is reserved.

Reserved for ODBA

This 136-byte field is reserved for ODBA.

The application program can use the returned PCB address, when available, to inspect the status code in the PCB and to obtain any other information needed by the application program.