gtpi1m3d | System Installation Support Reference |
The dynamic logical unit (LU) user exit, CDLY, allows you to specify the
values that are used to create resource definitions for new LU resources that
log on to the TPF system.
You can also use this user exit to specify which LU resources, if any, can
log on to the TPF system.
This user exit is called only if an LU resource tries to log on to the TPF
system and a resource definition does not already exist for that LU
resource. Therefore, the dynamic LU user exit can be called when:
- An LU resource logs on to the TPF system.
- An operator enters the ZNCNS INITIALIZE command for an LU 6.2
resource.
- The ROUTC macro is used to send a message to an application on another
processor and the receiving processor creates a resource definition.
- Functional management message routing (FMMR) support is used to send a
message to an application in another complex and the receiving processor
creates a resource definition.
Input
- R1
- Address of the parameter list, which contains the following:
- Four-byte address of a copy of the resource vector table (RVT) entry for
the LU resource, which is defined by the RV1VT DSECT.
See Table 4 for information about the fields in the copy of the RVT
entry that you can change with this user exit.
- Four-byte address of an area that contains the name of a process selection
vector (PSV) routine for the LU resource. (The PSV name is blank when
this user exit is called.)
See Programming Considerations for information about specifying the name of a PSV routine
for the LU resource.
Programming Considerations
- D0-D7 cannot be modified.
- EBX096-EBX099 cannot be modified.
- To avoid session initiation logic errors, do not allow the
entry control block (ECB) to give up control during processing of CDLY.
- Control is returned to the CDLX segment, which verifies the changes made
by this user exit.
- Table 2 shows the OSTG options for each LU type (except X.25)
that can be changed using this user exit. The OSTG options that can be
changed are indicated by the word EXIT. The OSTG options that are not
relevant or not supported are indicated by a dash (--). See TPF ACF/SNA Network Generation for a description of the
OSTG options.
Table 2. LU Types and User-Specified OSTG Options
OSTG Option
| LU Types
|
3277
| 3278
| 3284
| 3286
| 3287
| 3288
| 3289
| 3614
| 360X
| APSLU
| APPC
| FMMR
| NEF
|
---|
LEID=
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
|
UMODE=
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
|
PSV=
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| --
| --
| --
| EXIT
|
AWARE=
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
| EXIT
|
CHAIN=
| --
| --
| --
| --
| --
| --
| --
| --
| --
| --
| --
| --
| --
|
- Table 3 shows the OSTG options for each X.25-type resource
that can be changed using this user exit. The OSTG options that can be
changed are indicated by the word EXIT. REQUIRED indicates that you
must specify a value for the OSTG option. OPTIONAL indicates that you
can use the default value or specify a new value for the OSTG option.
The OSTG options that are not relevant or not supported are indicated by a
dash (--). See TPF ACF/SNA Network
Generation for a description of the OSTG options.
Table 3. X.25 LU Types and the Permitted OSTG Options
OSTG Option
| LU Types
|
MCHLU
| VCLU
| AX001
| AX002
| XALCI
| FTPI
|
---|
LEID=
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| EXIT (REQUIRED)
| EXIT (REQUIRED)
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
|
UMODE=
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
|
PSV=
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| EXIT (REQUIRED)
| EXIT (OPTIONAL)
|
AWARE=
| EXIT (OPTIONAL)
| EXIT (OPTIONAL)
| --
| --
| --
| --
|
CHAIN=
| --
| EXIT (OPTIONAL)
| --
| --
| --
| --
|
- Table 4 describes the fields in the copy of the RVT entry that you
can change with this user exit.
Table 4. Description of Fields in the Dynamic LU User Exit
Field
| Description
| Default Value
|
RV1LEIDF
| A 4-byte field that corresponds to the LEID= OSTG option. This
field contains the 1-byte length of the logical end-point identifier (LEID)
followed by the 1- to 3-byte LEID.
If you specify an LEID for a 3270, AX001, or AX002 LU resource, use the
following format, which will be verified when control is returned to the CDLX
segment:
- 3270
- Specify a 3-byte LEID for 3270 devices that will log on to non-SNA
applications (that is, applications that use an LEID to address a
terminal).
- AX001
- Specify a 2-byte LEID that consists of the line number and interchange
address of the terminal.
- AX002
- Specify a 1-byte LEID that consists of the line number of the
terminal.
- Note:
- If you specify an LEID for any other LU type, the format is not
verified when control is returned to the CDLX segment.
| X'0000'
|
RV1MODE3
| A 1-byte field that corresponds to the UMODE= OSTG option.
| X'00'
|
SNAAWARE bit in RV1MODE1
| A bit that corresponds to the AWARE= OSTG option.
| Off
|
SNACHAIN bit in RV1MODE2
| A bit that corresponds to the CHAIN= OSTG option.
| Off
|
RV1DVTP2
| A 1-byte field that identifies the X.25 LU type, which can be one
of the following:
- TP1MCH
- Multichannel link
- TP1VCL
- Virtual circuit
- TP1XA1
- Airlines X.25 type 1
- TP1XA2
- Airlines X.25 type 2
- TP1XALC
- Airlines line control interconnection (ALCI)
- TP1FTP
- Fast transaction processing interface (FTPI).
- Note:
- You must specify a value for this field when using X.25 LU
resources.
| None
|
See TPF ACF/SNA Network Generation for a
description of the OSTG options.
- Use the PSVNAME field in this user exit to specify the name of a PSV
routine for the LU resource. The PSVNAME field is a 6-byte field that
corresponds to the PSV= OSTG option.
- Note:
- If you specify a PSV name for an LU resource, that PSV routine
must be defined to the TPF system in at least 1 offline ACF/SNA
table generation (OSTG) RSC statement. See TPF
ACF/SNA Network Generation for more information about the OSTG program
and the RSC statement.
- This user exit is shipped by IBM to return the value 2 in R0 for every LU
resource that tries to log on to the TPF system using dynamic LU
support. This means that no LU resources can log on to the TPF system
using dynamic LU support until you update this user exit.
Return Values
R0 contains the return code:
- 0
- Success
- 2
- LU resource not authorized to log on to the TPF system.