ACCRDB command (X'2001')

The distributed data management (DDM) architecture ACCRDB command allocates a program specification block (PSB) on behalf of the source server. The PSB represents a connection between the DDM source server and an IMS database.

The PSB remains allocated until the database connection is closed and the communications conversation is terminated.

Format

Parameters

DSSHDR: The 6-byte header that contains information about the data stream structure (DSS).
LL: The length specified as a 2-byte binary integer. This length includes LL and CP.
CP: X'2001', the 2-byte codepoint of the ACCRDB command.
RDBNAM: A required parameter (X'2110') that contains the IMS PSB name that identifies the target database. The PSB name is a character string up to 8 bytes long. RDBNAM can optionally include the alias name of the IMS data store.
RDBACCCL: A required parameter that specifies the application manager that accesses the database. The codepoint for RDBACCCL is X'210F'. The value of RDBACCCL is reserved and must be X'2407'.
PRDID: A required parameter that specifies the release level of the source DDM server. The codepoint for PRDID is X'112E'.
PRDDTA: An optional parameter that specifies product-specific information that is passed to the target if the SRVCLSNM of the target server is not known when the ACCRDB command is issued. The codepoint for PRDDTA is X'2104'. This parameter can be ignored by the target server.
TYPDEFNAM: A required parameter (X'002F') that specifies the name of the data type definition. TYPDEFNAM consists of a 2-byte specification of length (LL), a 2-byte codepoint (CP), and the VALUE. The VALUE is reserved and must be QTDSQL370, which is the general EBCDIC SQL type definition for machines that use EBCDIC strings, IEEE floating-point numbers, and non-byte-reversed floating-point and integer numbers.

Usage

If no errors occur during the processing of the ACCRDB command, the IMS target server returns the ACCRDBRM reply message to indicate that the database has been allocated.

Chained command objects

No command objects can be chained to the ACCRDB command.

Positive reply messages

In response to the ACCRDB command, the IMS target DDM server returns to the source server the following positive reply messages:

ACCRDBRM: Access to database completed.; Codepoint: X'2201'; Specifies that the named database in the previous ACCRDB command is now available to the client for processing.

Error reply messages

In response to the ACCRDB command, the IMS target DDM server can return to the source DDM server the following error reply messages that are unique to the ACCRDB command:

Table 1. Possible error reply messages unique to the ACCRDB command
Codepoint of reply message	Name of reply message	Meaning of reply message
X'2203'	RDBATHRM	Not authorized to database.
X'2211'	RDBNFNRM	Database not found.
X'221A'	RDBAFLRM	RDB access failed reply message. If the RDBNAM parameter was specified on the ACCRDB command, the RDBAFLRM reply message indicates that the database (RDB) failed the attempted connection.