MODIFY DEFINE command
Abbreviations
Operand | Abbreviation |
---|---|
MODIFY | F |
AUTOSES | AUTO |
DELETE=ALLOW | DELETE=A or DEL=ALLOW or DEL=A |
DELETE=NALLOW | DELETE=N or DEL=NALLOW or DEL=N |
DELETE=UNUSE | DELETE=U or DEL=UNUSE or DEL=U |
DDRAINL=ALLOW | DDRAINL=A or DDRL=ALLOW or DDRL=A |
DDRAINL=NALLOW | DDRAINL=N or DDRL=NALLOW or DDRL=N |
DRESPL=ALLOW | DRESPL=A or DRSP=ALLOW or DRSP=A |
DRESPL=NALLOW | DRESPL=N or DRSP=NALLOW or DRSP=N |
LOGMODE | LOG |
LUNAME | LU |
Purpose
The MODIFY DEFINE command establishes new entries, modifies existing entries, or deletes unusable entries in the LU-mode table for the specified application program. The DEFINE values stored in the LU-mode table are used when VTAM® processes a CNOS transaction originated by the partner LU or when a CNOS request is issued from the application program (local LU) without a CNOS structure.
When VTAM receives the MODIFY DEFINE command, it overlays the existing entry with the values specified.
Operands
- procname
- The procedure name for the command. If procname in the START command was specified as startname.ident, where startname is the VTAM start
procedure and ident is the optional identifier,
either startname.ident or ident can be specified for procname.
If procname in the START command was startname, startname must be specified for procname.
- AUTOSES=number_of_winner_sessions
- Specifies the number of contention-winner sessions to activate automatically, rather than by allocation requests from the application program. The valid range is 0–32767. If AUTOSES is not coded on the APPL statement, the default is zero.
- DDRAINL
- Specifies whether the source side can drain its allocation requests
when the application program is a target of a CNOS request that resets
the session limits to zero. This operand is valid only
if the session limits are being reset to zero.
- DDRAINL=ALLOW
- Specifies that the application program is allowed to drain its allocation requests when the application program is the target of a CNOS request that resets the session limits to zero.
- DDRAINL=NALLOW
- Specifies that the application program is not allowed to drain its allocation requests.
- DELETE
- Specifies whether a mode name entry can be deleted from the LU-mode
table.
- DELETE=ALLOW
- Specifies that a mode name entry can be deleted from the LU-mode table.
- DELETE=NALLOW
- Specifies that a mode name entry cannot be deleted from the LU-mode table.
- DELETE=UNUSE
- Specifies that an unusable mode name entry is to be deleted from
the LU-mode table. Note: DELETE=UNUSE is valid only for applications programs defined with OPERCNOS=ALLOW and APPC=YES on the APPL definition statement in the application program major node.
- DLIMITS=(dseslim,dminwinl,dminwinr)
- Specifies the negotiation limits that are allowed between the
source side and target side. If DLIMITS is not coded on the APPL statement,
the default is (2,1,1).
- dseslim
- Specifies the maximum number of sessions between the source side and the target side. This number applies uniquely to each logon mode name for which sessions can be established with a partner LU. The valid range is 0–32767.
- dminwinl
- Specifies the minimum number of parallel sessions for which the source side is guaranteed to be the contention winner. This number applies uniquely to each logon mode name for which sessions can be established with a partner LU. The valid range is 0–32767.
- dminwinr
- Specifies the minimum number of parallel sessions for which the partner LU is guaranteed to be the contention winner. This number applies uniquely to each logon mode name for which sessions might be established with a partner LU. The valid range is 0–32767.
- DRESPL
- Specifies whether the LU is allowed to assume responsibility for
deactivating sessions if a CNOS request is received identifying the
LU as the responsible LU.
- DRESPL=ALLOW
- Specifies that VTAM accepts a CNOS request specifying that the LU is responsible for deactivating sessions.
- DRESPL=NALLOW
- Specifies that VTAM does not accept a CNOS request specifying that the LU is responsible for deactivating sessions.
- ID=appl_name
- Specifies the name of the LU 6.2 application program to which the command applies. appl_name cannot be a network-qualified name.
- LOGMODE=logon_mode_name
- Specifies the name of the logon mode entry for which session limit and contention-winner polarity values are to be changed. The SNASVCMG LOGMODE name is not allowed in the operand. The SNASVCMG LOGMODE is managed internally by VTAM.
- LUNAME=lu_name
- Specifies the name of the partner LU to which the change in the
session limit and contention-winner polarity values apply. The name can be a network-qualified name in the form of netid.luname.
If lu_name is an ACB name, and the ACB name matches the name on the APPL definition statement, then you can use a network-qualified ACB name.
If PARMS=(NQNAMES=NO) is coded on the ACB macro, and a network-qualified name is specified, the network identifier is ignored.
If PARMS=(NQNAMES=YES) is coded on the ACB macro, luname must be a network-qualified name.