CSRIDAC — Request or terminate access to a data object

Call CSRIDAC to:

Request access to a data object
Terminate access to a data object

Code the CALL following the syntax of the high-level language you are using and specifying all parameters in the order shown below. For parameters that CSRIDAC uses to obtain input values, assign values that are acceptable to CSRIDAC. For parameters that CSRIDAC ignores, assign any value that is valid for the particular parameter’s data type.

The parameter values that CSRIDAC uses depends on whether you are requesting access to an object or terminating access.

To request access to a data object, specify BEGIN for operation_type, and assign values, acceptable to CSRIDAC, to the following parameters:
- object_type
- object_name if the object is permanent
- scroll_area
- object_state if the object is permanent and object_type specifies DSNAME
- access_mode if the object exists and is permanent
- object_size if the object is new or temporary
- object_size if the object is new or temporary
CSRIDAC ignores other parameter values. CSRIDAC returns values in object_id, high_offset, return_code, and reason_code.
To terminate access to a data object, specify END for operation_type, and assign a value, acceptable to CSRIDAC, to object_id. CSRIDAC ignores other parameter values. CSRIDAC returns values in return_code and reason_code.

CALL statement	Parameters
CALL CSRIDAC	(operation_type ,object_type ,object_name ,scroll_area ,object_state ,access_mode ,object_size ,object_id ,high_offset ,return_code ,reason_code)

operation_type

Specifies the type of operation the service is to perform:

To request access to an object, specify BEGIN.
To terminate access to an object, specify END. If the object is temporary, CSRIDAC deletes it.

Define operation_type as character data of length 5. If you specify END, pad the string on the right with 1 or 2 blanks.

,object_type

Specifies the type of object. The types are:

DDNAME: The object is an existing (OLD) VSAM linear data set allocated to the file whose DDNAME is specified by object_name.
DSNAME: The object is the linear VSAM data set whose name is specified by object_name. The data set may already exist or may be a new data set that you want window services to create.
TEMPSPACE: The object is a temporary data object. Window services deletes the object when your program calls CSRIDAC and operation_type equals END.

If operation_type is BEGIN, you must supply a value.

Define this parameter as character data of length 9. If you specify either DDNAME or DSNAME, pad the string on the right with 1 to 3 blanks.

,object_name

Specifies the data set name of a permanent object or the DDNAME of a data definition (DD) statement that defines a permanent object.

If object_type is DDNAME, object_name must contain the name of a DD statement.
If object_type is DSNAME, object_name must contain the data set name of the permanent object.

If operation_type is BEGIN and object_type is DDNAME or DSNAME, you must supply a value for object_name.

Define object_name as character data of length 1 to 45. If object_name contains fewer than 45 characters, pad the name on the right with a blank.

,scroll_area

Specifies whether window services is to create a scroll area for the data object.

YES: Create a scroll area.
NO: Do not create a scroll area.

If operation_type is BEGIN and object_type is TEMPSPACE, specify YES.

Define scroll_area as character data of length 3. If you specify NO, pad the string on the right with a blank.

,object_state

Specifies the state of the object.

OLD: The object exists.
NEW: The object does not exist and window services must create it.

If operation_type is BEGIN and object_type is DSNAME, you must supply a value for object_state.

Define object_state as character data of length 3.

,access_mode

Specifies the type of access required.

READ: READ access.
UPDATE: UPDATE access.

If operation_type is BEGIN and object_type is DDNAME or DSNAME, you must supply a value for access_mode. For a new or temporary data object, window services assumes UPDATE.

Define access_mode as character data of length 6. If you specify READ, pad the string on the right with 1 or 2 blanks.

,object_size

Specifies the maximum size of the new object in units of 4096 bytes.

This parameter is required if either of the following conditions is true:

Operation_type is BEGIN, object_type is DSNAME, and object_state is NEW
Operation_type is BEGIN and object_type is TEMPSPACE

Define object_size as integer data of length 4.

,object_id

Specifies the object identifier.

When operation_type is BEGIN, the service returns the object identifier in this parameter. Use the identifier to identify the object to other window services.

When operation_type is END, you must supply the object identifier in this parameter.

Define object_id as character data of length 8.

,high_offset

When CSRIDAC completes, high_offset contains the size of the existing object expressed in blocks of 4096 bytes

Define high_offset as integer data of length 4.

,return_code

When CSRIDAC completes, return_code contains the return code. Define return_code as integer data of length 4.

Return codes and reason codes are explained under Return codes and reason codes.

,reason_code

When CSRIDAC completes, reason_code contains the reason code. Define reason_code as integer data of length 4.

Return codes and reason codes are explained under Return codes and reason codes.