gtpg2m2hGeneral Macros

GDSNC-Get General Data Set Entry

This general macro is provided to initialize a user's file address reference word (FARW) with the data necessary to access a general data set or a volume of a general data set.

Format




Notes:

  1. symbol1

label
A symbolic name can be assigned to the macro statement.

datalevel
This is a core block reference word (CBRW); file address reference word (FARW); and file address extension word (FAXW) (D0-DF).

DECB=(reg)|label1
The label or general register (R0-R7) containing the address of the data event control block (DECB), which identifies the CBRW, FARW, and FAXW.

symbol1
This is an open (O) or close (C) character.

RCT
This is the record number format of the data set; the default value is A. Valid values are:

A
TPF record number format

N
Non-TPF (OS/VS) record number format

SIZE
The record size of the data set. The default value is 4. Valid values are:

L
Large (1055 bytes)

S
Small (381 bytes)

U
Undefined

4
4K (4095 bytes)

The SIZE = U parameter cannot be used with TPF data sets. For TPF data sets only SIZE = L, S, or 4 will be accepted.

The SIZE = U parameter is used for non-TPF data sets; such as OS data sets. When SIZE = U is specified the data set is divided into 4K-byte allocations. If the data set was not defined by the user to 4K-byte allocations, any additional records at the end of the tracks will not be addressable.

WORK
The location where the relative record number (RRN) of the desired record in the data set is specified. The default is NO. Valid values are:

NO
Relative record number is in the FARW extension.

YES
Relative record number is in the user's work area.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.