Network Print Facility's Routing Data Area (RDA)

The routing data is a combination of data from the routing and options files and is accessible to all three exits. If the general routing exit builds the routing data area, it should initialize all fields. Fields that can be modified by either the specific routing exit or the input record exit are marked.

Field Name

Field Description

RTDAMAJK

An 8-byte character field containing the major name for this routing. For JES, this corresponds to the CLASS parameter in the JCL. For VTAM®, this corresponds to the LU Name.

This field should not be modified.

RTDAMINK

An 8-byte character field containing the minor name for this routing. For JES, this corresponds to the DEST parameter in the JCL. For VTAM, this must contain nonblanks.

This field should not be modified.

RTDASREX

An 8-byte character field containing the name of the specific routing exit, if one was specified. If not, this field contains binary zeros.

This field should not be modified.

RTDAIREX

An 8-byte character field containing the name of the input record exit if one was specified. If not, this field contains binary zeros.

This field should not be modified.

RTDARTRS

A fullword binary field which gives the period of time the system should retain data for this routing after a successful transmission to LPR. This field has the format dddhhmm, where:

ddd: The number of days to retain the file after successful transmission to LPR.
hh: The number of hours to retain the file after successful transmission to LPR.
mm: The number of minutes to retain the file after successful transmission to LPR.

The total time to retain the file is the sum of the days, hours and minutes.

This field can be modified by either exit.

RTDARTRU

A fullword binary field which gives the period of time the system should retain data for this routing after an attempting the specified number of retries without success. This field has the format dddhhmm, where:

ddd: The number of days to retain the file after an unsuccessful transmission to LPR.
hh: The number of hours to retain the file after an unsuccessful transmission to LPR.
mm: The number of minutes to retain the file after an unsuccessful transmission to LPR.

The total time to retain the file is the sum of the days, hours and minutes.

This field can be modified by either exit.

RTDARTRR

A fullword binary field which gives the period of time the system should wait before attempting a retry on this routing after an unsuccessful attempt to transmit to LPR. This field has the format dddhhmm, where:

ddd: The number of days to wait before a retry of an unsuccessful transmission to LPR.
hh: The number of hours to wait before a retry of an unsuccessful transmission to LPR.
mm: The number of minutes to wait before a retry of an unsuccessful transmission to LPR.

The total time to wait before a retry of an unsuccessful transmission to LPR is the sum of the days, hours and minutes.

This field can be modified by either exit.

RTDADEST

A halfword binary number containing the number of destinations described by this routing record. The default is 1 (normal routing). A number greater than 1 means this record represents a specific broadcast.

This field can be modified but caution is advised. The system has no way to determine if it is consistent with the number of destinations described in RTDANAMS.

RTDARTRL

A halfword binary field which specifies the number of retry attempts to be made on this routing. If the file is not successfully transmitted by LPR within this number of retries, it changes to retain status.

This field can be modified by either exit.

RTDATYPE

A 1-byte character field containing the value 'N'. This record represents one or more destinations which have the same characteristics. It might be followed by additional records describing other destinations for the same routing. If the field NO_OF_DEST is 1, the record represents a normal routing. If the field NO_OF_DEST is greater than 1, the record represents a specific broadcast.

This field can be modified but caution is advised. The system has no way to determine if it is consistent with the number of destinations described in RTDANAMS.

RTRECTYP/RTDARTYP

A 3-byte character field containing the record type.

This field can be modified by the specific routing exit or the input record exit at OPEN time.

RTFUNCTN/RTDAFUNC

An 8-byte character field containing the function. This can be one of four conditions affecting the input record exit (open, put, close, and term-release.)

RTLRECL/RTDARECL

A fullword binary field specifying the logical record length for the print file

This field can be modified by the specific routing exit or the input record exit at OPEN time.

RTBLKSZ/RTDABLKS

A fullword binary field specifying the block size for the print file.

This field can be modified by the specific routing exit or the input record exit at OPEN time.

RTBUFSZ/RTDABUFS

A fullword binary field specifying the buffer size for the print file.

This field can be modified by the specific routing exit or the input record exit at OPEN time.

RTDAOPTN

A 16-byte character field containing the name of the Options record for this print job.

This field should not be modified.

RTDAOPTL

A halfword binary field containing the length of the options data used for this routing. This length must be 255 or less.

This field can be modified by either exit.

RTDAOPTD

A 256-byte character field containing up to 255 bytes of option data for this print job (the right-most byte of this field is ignored). They correspond to the options used for LPR. See the file description section for values.

This field can be modified by either exit.

RTDANAMS

A variable area containing a destination data area for each destination. The format of the destination data areas is as follows:

Field Name: Field Description
RTDANAML: A 2-byte binary field specifying the length of INET_NAME
RTDAPRTL: A 2-byte binary field specifying the length of PRT_NAME
RTDAINAM: A variable length character field up to 255 characters in length specifying the internet name or address of the destination host for the first or only destination. This field is case-sensitive.
RTDAPNAM: A variable length character field up to 255 characters in length specifying the name of the printer to be used at the remote host for the first or only destination. This field is case-sensitive.

These fields might be modified by either exit. Care should be taken to make sure that the resulting modifications are consistent. Also, if the routing data area was built by NPF, there will be no additional storage at the end for additions.