>>-MODIFY-- --procname--,--VTAMOPTS----------------------------->
>--+-----------------------------------+------------------------>
'-,--AFFDELAY--=--number_of_seconds-'
>--+-----------------------+--+---------------------------+----->
'-,--ALSREQ--=--+-NO--+-' | (1) |
'-YES-' '-,--API64R--=--+-NO--+-----'
'-YES-'
(2)
>--+--------------------------------------+--------------------->
'-,--APPNCOS--=--class-of-service_name-'
>--+-----------------------------+------------------------------>
'-,--ASIRFMSG--=--+-ALLSSCP-+-'
+-OLUSSCP-+
'-NONE----'
>--+------------------------+----------------------------------->
'-,--AUTHLEN--=--+-NO--+-'
'-YES-'
>--+-----------------------------+------------------------------>
'-,--AUTORTRY--=--+-AUTOCAP-+-'
+-CDRM----+
+-ALL-----+
'-NONE----'
>--+---------------------------+-------------------------------->
'-,--AUTOTI--=--time_period-'
(3)
>--+--------------------------+--------------------------------->
'-,--BNDYN--=--+-NONE----+-'
+-LIMITED-+
'-FULL----'
(4)
>--+---------------------------+-------------------------------->
'-,--BNORD--=--+-DEFINED--+-'
'-PRIORITY-'
>--+------------------------------------------------------+----->
'-,--BSCMDRS--=--+-STATS-----------------------------+-'
+-NOSTATS---------------------------+
+-(--,--INOPS--)--------------------+
+-(--,--NOINOPS--)------------------+
'-(--+-STATS--+-,--INOPS---+---+--)-'
| '-,--NOINOPS-' |
'-NOSTATS--+-,--INOPS---+-'
'-,--NOINOPS-'
>--+-----------------------+------------------------------------>
'-,--CDRDYN--=--+-YES-+-'
'-NO--'
>--+------------------------------------+----------------------->
| (5) |
'-,--CDSREFER--=--number_of_CDSs-----'
(6)
>--+----------------------------------+------------------------->
'-,--CMPMIPS--=--compression_ratio-'
>--+------------------------------+----------------------------->
'-,--CNNRTMSG--=--+-SUPPRESS-+-'
'-NOSUPP---'
>--+----------------------------------+------------------------->
'-,--CMPVTAM--=--compression_level-'
(7)
>--+--------------------------+--------------------------------->
'-,--CONNTYPE--=--+-APPN-+-'
'-LEN--'
(8)
>--+--------------------------+--------------------------------->
'-,--CPCP--=--+-YES------+-'
+-NO-------+
+-LEASED---+
'-SWITCHED-'
>--+-------------------------------------------+---------------->
'-,--CSALIMIT--=--+-value-----------------+-'
'-(--value--+------+--)-'
'-,--F-'
>--+----------------------------------------+------------------->
'-,--CSA24--=--+-value-----------------+-'
'-(--value--+------+--)-'
'-,--F-'
>--+-------------------------+---------------------------------->
'-,--DIALRTRY--=--+-YES-+-'
'-NO--'
(9)
>--+------------------------------------+----------------------->
'-,--DIRSIZE--=--number_of_resources-'
(10)
>--+----------------------------+------------------------------->
'-,--DIRTIME--=--time_period-'
>--+---------------------------------------------+-------------->
'-,--DISCNTIM--=--(time_period1,time_period2)-'
>--+----------------------------------------------------+------->
'-,--DLRORDER--=--+-STATNID------------------------+-'
+-CPNAME-------------------------+
+-(--,--FIRST--)-----------------+
+-(--,--ONLY--)------------------+
+---(--CPNAME--+-,--FIRST--)-+---+
| '-,--ONLY-----' |
'-(--STATNID--+-,--FIRST--)-+----'
'-,--ONLY-----'
>--+----------------------------------+------------------------->
| (11) |
'-,--DSIRFMSG--=--+-ALLSSCP-+------'
+-OLUSSCP-+
'-NONE----'
>--+------------------------------------+----------------------->
'-,--DSPLYDEF--=--number_of_messages-'
>--+------------------------------+----------------------------->
'-,--DSPLYWLD--=--+-FULLWILD-+-'
+-NOWILD---+
+-OPERONLY-+
'-POAONLY--'
>--+--------------------------+--------------------------------->
'-,--DUPDEFS--=--+-ALL---+-'
+-NONE--+
+-APPL--+
'-DEPLU-'
>--+----------------------------------+------------------------->
'-,--DYNDLGMD--=--+-logmode_name-+-'
'-NONE---------'
>--+--------------------------------+--------------------------->
'-,--DYNMODTB--=--+-table_name-+-'
'-NONE-------'
>--+-------------------------+---------------------------------->
'-,--EEPORTCK--=--+-NO--+-'
'-YES-'
(12)
>--+-------------------------+---------------------------------->
'-,--EEHPRANR--=--+-NO--+-'
'-YES-'
>--+--------------------------------------------+--------------->
| (13) |
'-,--EEVERIFY--=--+-ACTIVATE----------+------'
+-NEVER-------------+
'-Number_of_minutes-'
>--+---------------------------+-------------------------------->
'-,--ENCRPREF--=--+-NONE--+-'
'-value-'
(14)
>--+--------------------------+--------------------------------->
'-,--ENCRYPTN--=--+-YES--+-'
+-NO---+
+-CCA--+
+-CUSP-+
+-24---+
'-31---'
(15)
>--+-------------------------+---------------------------------->
'-,--ENSEMBLE--=--+-NO--+-'
'-YES-'
>--+-----------------------------+------------------------------>
'-,--ESIRFMSG--=--+-ALLSSCP-+-'
+-OLUSSCP-+
'-NONE----'
>--+--------------------------------------+--------------------->
'-,--EXPFLTRM--=--expedited_flow_count-'
>--+-----------------------------+------------------------------>
'-,--FSIRFMSG--=--+-ALLSSCP-+-'
+-OLUSSCP-+
'-NONE----'
>--+------------------------+----------------------------------->
'-,--GVBKDLY--=--+-NO--+-'
'-Yes-'
>--+---------------------------------------------------+-------->
| (16) |
'-,--HOSTNAME--=--+-fully_qualified_hostname-+------'
'-NONE---------------------'
>--+-------------------------------------------+---------------->
'-,--HOTIOTRM--=--percentage_of_buffer_pool-'
(17)
>--+------------------------------+----------------------------->
'-,--HPRITMSG--=--+-BASE-----+-'
'-ENHANCED-'
(17)
>--+-------------------------+--+--------------------+---------->
'-,--HPRNCPBF--=--+-YES-+-' '-,HPRPSDLY=ps_delay-'
'-NO--'
(17)
>--+----------------------------------+------------------------->
'-,--HPRPSMSG--=--+-ALL----------+-'
'-ps_msg_count-'
>--+------------------------------------------------------------------------------+-->
'-,--HPRPST--=--(--low_limit--,--med_limit--,--high_limit--,--network_limit--)-'
(17) (18)
>--+------------------------------+----------------------------->
'-,--HPRSESLM--=--+-NOLIMIT--+-'
'-sess_lim-'
(17)
>--+-----------------------------------+------------------------>
'-,--HPRSTALL--=--+-0-------------+-'
'-timeout_limit-'
(19) (20) (21)
>--+---------------------------------------------------------------------------+----------------->
| .-ALL--------. .-ALL------. |
'-,--INOPCODE--=--(--+------------+--,--+----------+--,--+-DUMPENABLE--+--)-'
+-ALL--------+ +-ALL------+ +-DUMPDISABLE-+
'-modulename-' '-inopcode-' '-DUMPDEFAULT-'
>--+------------------------------+----------------------------->
'-,--INOPDUMP--=--+-ON-------+-'
| (22) |
'-OFF------'
>--+--------------------------------+--------------------------->
'-,--IOINT--=--number_of_seconds-'
>--+-----------------------------------------+------------------>
'-,--IOMSGLIM--=--number_of_message_pairs-'
>--+------------------------------+----------------------------->
'-,--IOPURGE--=--timeout_value-'
>--+-------------------------------+---------------------------->
| (23) |
'-,--IPADDR--=--ip_address------'
>--+----------------------------+------------------------------->
'-,--IPINFO--=--+-SENDALL--+-'
+-SNDLOCAL-+
+-DISPONLY-+
'-NONE-----'
.-,--IQDCHPID--=--ANY---------.
>--+-----------------------------+------------------------------>
| (24) |
'-IQDCHPID--=--+-ANY---+------'
+-NONE--+
'-CHPID-'
>--+-------------------------+---------------------------------->
'-,--IQDIOSTG--=--+-MAX-+-'
+-AVG-+
+-MIN-+
'-NNN-'
>--+-----------------------------------------+------------------>
'-,--ISTCOSDF--=--+-ALL-----------------+-'
+-APPL----------------+
+-DEPLU---------------+
+-INDLU---------------+
+-NONE----------------+
| .-,---------. |
| V | |
'-(----+-APPL--+-+--)-'
+-DEPLU-+
'-INDLU-'
>--+-----------------------------------+------------------------>
'-,--LIMINTCP--=--number_of_seconds-'
>--+---------------------------------+-------------------------->
| (25) |
'-,--LSIRFMSG--=--+-ALLNNS-+------'
+-OLUNNS-+
'-NONE---'
>--+-------------------------------------------+---------------->
'-,--MAXEETST--=--max_ee_connectivity_tests-'
(26)
>--+--------------------------------------------------+--------->
'-,--MAXLOCAT--=--max_locate_congestion_threshhold-'
>--+--------------------------+--------------------------------->
'-,--MAXLURU--=--ru_length-'
>--+---------------------------------+-------------------------->
'-,--MAXSSCPS--=--number_of_sscps-'
>--+-------------------------------+---------------------------->
'-,--MIHTMOUT--=--units_of_time-'
>--+-------------------------------+---------------------------->
| (27) |
'-,--MPCACT--=--+-NOWAIT-+------'
'-WAIT---'
>--+---------------------------+--+-----------------------+----->
'-,--MSGLEVEL--=--+-BASE--+-' '-,--MSGMOD--=--+-YES-+-'
+-V4R1--+ '-NO--'
+-V4R2--+
+-V4R3--+
+-V4R4--+
'-CS390-'
>--+-----------------------------------+------------------------>
| (28) |
'-,--MULTPATH--=-------+-TCPVALUE-+-'
'-NO-------'
>--+---------------------------------------+-------------------->
'-,--NACPROBE--=--+-NODUMP------------+-'
+-DUMP--------------+
'-Number_of_minutes-'
>--+----------------------------------------+------------------->
| (29) |
'-,--NNSPREF--=--+-NONE----------------+-'
'-network_node_server-'
>--+---------------------------+-------------------------------->
'-,--NQNMODE--=--+-NAME---+-'
'-NQNAME-'
(30)
>--+-----------------------------------------+------------------>
'-,--NUMTREES--=--number_of_routing_trees-'
>--+-----------------------------------+------------------------>
'-,--OSIEVENT--=--+-ALL-----------+-'
+-NONE----------+
| (31) |
'-PATTERNS------'
>--+------------------------+----------------------------------->
'-,--OSIMGMT--=--+-YES-+-'
'-NO--'
>--+----------------------------------+------------------------->
| (32) |
'-,--OSITOPO--=--+-ALLCDRSC------+-'
'-ILUCDRSC --'
>--+-----------------------------------+------------------------>
'-,--PDTRCBUF--=--number_of_buffers-'
>--+------------------------------------+----------------------->
'-,--PIUMAXDS--=--calculation_factor-'
>--+------------------------------+----------------------------->
'-,--PLUALMSG--=--+-SUPPRESS-+-'
'-NOSUPP---'
>--+-----------------------------+--+-----------------------+--->
| (33) | '-,--PPOLOG--=--+-YES-+-'
'-PMTUD--=--+-TCPVALUE-+------' '-NO--'
'-NO-------'
>--+-------------------------------------------------------------------------------------------------+-->
'-,--PSRETRY--=--(--low_tp_int--,--med_tp_int--,--high_tp_int--,--network_tp_int--,--+-IMMED-+--)-'
'-SCHED-'
>--+--------------------------+--------------------------------->
'-,--PSSTRACE--=--+-NORB-+-'
+-IRB--+
+-SRB--+
'-BOTH-'
>--+------------------------------+----------------------------->
'-,--PSWEIGHT--=--+-EQUAL----+-'
+-LESSTHAN-+
'-SAMEROUT-'
>--+------------------------+----------------------------------->
'-,--QDIOSTG--=--+-MAX-+-'
+-AVG-+
+-MIN-+
'-NNN-'
(34)
>--+-----------------------------+------------------------------>
'-,--RESUSAGE--=--usage_limit-'
(35)
>--+----------------------------------+------------------------->
'-,--ROUTERES--=--resistance_value-'
>--+-----------------------------+------------------------------>
'-,--RSIRFMSG--=--+-ALLSSCP-+-'
+-OLUSSCP-+
'-NONE----'
>--+------------------------------------+----------------------->
'-,--SAVERSCV--=--+-(,FREE)--------+-'
+-(,KEEP)--------+
+-NO-------------+
+-(NO,FREE)------+
+-(NO,KEEP)------+
+-YES------------+
+-(YES,FREE)-----+
+-(YES,KEEP)-----+
+-SAWDATA--------+
+-(SAWDATA,FREE)-+
'-(SAWDATA,KEEP)-'
>--+------------------------------------+----------------------->
'-,--SAWMXQPK--=--calculation_factor-'
>--+-------------------------------------------------------+---->
'-,--SDLCMDRS--=--+-YES-------------------------------+-'
+-NO--------------------------------+
+-STATS-----------------------------+
+-NOSTATS---------------------------+
+-(--,--INOPS--)--------------------+
+-(--,--NOINOPS--)------------------+
'-(--+-STATS--+-,--INOPS---+---+--)-'
| '-,--NOINOPS-' |
'-NOSTATS--+-,--INOPS---+-'
'-,--NOINOPS-'
>--+----------------------------+------------------------------->
'-,--SIRFMSG--=--+-ALLSSCP-+-'
+-OLUSSCP-+
'-NONE----'
>--+-----------------------------------------+------------------>
'-,--SLOWVAL--=--+-warn_time------------+-'
'-(warn_time,end_time)-'
>--+------------------------------+----------------------------->
'-,--SLUALMSG--=--+-SUPPRESS-+-'
'-NOSUPP---'
>--+------------------------+----------------------------------->
'-,--SNAMGMT--=--+-YES-+-'
'-NO--'
(36)
>--+--------------------------------+--------------------------->
'-,--SNVC--=--subnet_visit_count-'
(37)
>--+----------------------------+------------------------------->
'-,--SORDER--=--+-ADJSSCP--+-'
+-APPN-----+
+-APPNFRST-+
'-SUBAREA--'
>--+------------------------+----------------------------------->
'-,--SRCHRED--=--+-OFF-+-'
'-ON--'
(38)
>--+------------------------------------------+----------------->
'-,--SRCOUNT--=--number_of_search_requests-'
(39)
>--+----------------------------------+------------------------->
'-,--SRTIMER--=--number_of_seconds-'
>--+-----------------------------+------------------------------>
'-,--SSCPORD--=--+-DEFINED--+-'
'-PRIORITY-'
>--+-----------------------------------+------------------------>
'-,--SSDTMOUT--=--number_of_seconds-'
(40)
>--+-----------------------------+------------------------------>
'-,--SSEARCH--=--+-YES------+-'
+-NO-------+
+-CACHE----+
'-APPNFRST-'
>--+-----------------------+------------------------------------>
'-,--SUPP--=--+-NOSUP-+-'
+-INFO--+
+-WARN--+
+-NORM--+
'-SER---'
>--+----------------------------------------------------+------->
'-,--SWNORDER--=--+-CPNAME-------------------------+-'
+-STATNID------------------------+
+-(--,--FIRST--)-----------------+
+-(--,--ONLY--)------------------+
+---(--CPNAME--+-,--FIRST--)-+---+
| '-,--ONLY-----' |
'-(--STATNID--+-,--FIRST--)-+----'
'-,--ONLY-----'
>--+----------------------------------+------------------------->
| (41) |
'-,--TCPNAME--=--tcp_job-name------'
(42)
.-TDUDIAG--=--1000-------------------.
>--+------------------------------------+----------------------->
'-TDUDIAG--=--+-resource_threshold-+-'
+-ALWAYS-------------+
'-NEVER--------------'
(43)
>--+------------------------------------------------------+------->
'-,--UNRCHTIM--=--+-unreachable_time-----------------+-'
+-(,partner_limit)-----------------+
'-(unreachable_time,partner_limit)-'
>--+------------------------------+----------------------------->
'-,--UPDDELAY--=--maximum_time-'
>--+-----------------------------+--+-----------------------+--->
'-,--VARYWLD--=--+-FULLWILD-+-' '-,--VFYRED--=--+-YES-+-'
+-NOWILD---+ '-NO--'
+-OPERONLY-+
'-POAONLY--'
(44)
>--+-------------------------------------+---------------------->
'-,--VFYREDTI--=--+-OFF-------------+-'
+-0---------------+
'-reduction_timer-'
(45)
>--+-------------------------+--+---------------------+--------->
'-,--VOSDEACT--=--+-YES-+-' '-,--VRTG--=--+-YES-+-'
'-NO--' '-NO--'
(46)
>--+-------------------------+---------------------------------><
'-,--VRTGCPCP--=--+-YES-+-'
'-NO--'
Notes:
- API64R can be modified only when running in z/Architecture® mode.
- APPNCOS can be modified only if NODETYPE was specified during
VTAM START processing.
- BNDYN can be modified only if BN=YES was specified during
VTAM START processing.
- BNORD can be modified only if BN=YES was specified during
VTAM START processing.
- CDSREFER can be modified only if NODETYPE=NN and CDSERVR=NO
were specified during VTAM START processing.
- CMPMIPS is meaningful only if the value for CMPVTAM is greater
than 1.
- CONNTYPE can be modified only if NODETYPE was specified during
VTAM START processing.
- CPCP can be modified only if NODETYPE was specified during
VTAM START processing.
- DIRSIZE can be modified only if NODETYPE=NN was specified
during VTAM START processing.
- DIRTIME can be modified only if NODETYPE=NN was specified
during VTAM START processing.
- Because of the volume of messages that can be generated, it is
not recommended that this option be enabled during normal operation.
Instead, it is recommended that this option be enabled (using the
MODIFY VTAMOPTS command) on all necessary hosts only when trying to
diagnose specific problems. After the problem has been diagnosed or
documentation has been collected, this option should be disabled once
again (using the MODIFY VTAMOPTS command).
- EEHPRANR is meaningful only when the NODETYPE=NN start option is also used.
- The EEVERIFY start option is meaningful only if VTAM provides
RTP-level HPR support. The EEVERIFY start option can be modified only
if the NODETYPE start option is specified and the RTP value is specified
on the HPR start option.
- The ENCRYPTN start option cannot be modified if ENCRYPTN=NO
was specified during VTAM START processing.
- The ENSEMBLE setting is used to either permit or deny connectivity
to the intraensemble data network and the intranode management network.
The ensemble setting permits or denies connectivity by either allowing
or denying activation of OSX and OSM interfaces. Modifying the ENSEMBLE
start option does not cause z/OS Communications Server to take action
on active OSX or OSM interfaces.
- HOSTNAME can be modified only if NODETYPE was specified during
VTAM START processing. Displays of VTAM start options will show the
new value immediately; however, the new value will not be used until
all Enterprise Extender lines, whose GROUP definition statements do
not have HOSTNAME explicitly coded, are inactive. Any subsequent line
activation from the Enterprise Extender XCA major node, whose GROUP
definition statements do not have HOSTNAME explicitly coded, will
make use of the new HOSTNAME start option value. The IPADDR start
option, if it is in effect at the time when the MODIFY VTAMOPTS,HOSTNAME=hostname is specified, will be reset (that is,
set to a value of 0.0.0.0) as part of the MODIFY processing. The value
NONE can be used to clear the setting of the HOSTNAME start option.
HOSTNAME and IPADDR cannot be modified using one MODIFY VTAMOPTS command.
If both start options are specified on the same MODIFY command, they
will both be ignored and message IST1917I will be generated.
- This option is meaningful only if VTAM provides RTP-level HPR support.
- If the current value of the HPRSESLM start option is DISABLED,
then the HPRSESLM value can be changed only by stopping and restarting VTAM.
- When specifying an InOpCode for the second parameter, always
specify three digits by including any leading zeros.
- If an InOpCode is specified for the second parameter, the
first parameter cannot be ALL.
- INOPCODE has no effect unless INOPDUMP is active for the
resource when an inoperative condition is detected. See the section called MODIFY INOPCODE command in z/OS Communications Server: SNA Operation for
more details.
- When altering the INOPDUMP VTAM start option, the resulting
INOPDUMP status is propagated to all TRLEs in the TRL major node and
becomes the default status for any subsequently activated TRLEs.
- IPADDR can be modified only if NODETYPE was specified during
VTAM START processing. The new value will not be used until all lines,
defined with or defaulting to the old value of the IPADDR start option,
in the XCA major node used for Enterprise Extender are inactive. However,
displays of VTAM start options will show the new value immediately.
Any subsequent line activation from the Enterprise Extender XCA major
node, whose GROUP definition statement does not specify the IPADDR
operand, will make use of the new IPADDR start option value. The HOSTNAME
start option, if it is in effect at the time when the MODIFY VTAMOPTS,IPADDR=ip_address is specified, will be reset (that
is, set to a value of NONE) as part of the MODIFY processing. The
value of 0.0.0.0, or an IPv6 address of all zeros, usually written as ::, can be used to clear the setting of the IPADDR start
option. HOSTNAME and IPADDR cannot be modified using one MODIFY VTAMOPTS
command. If both start options are specified on the same MODIFY command,
they will both be ignored and message IST1917I will be generated.
- The IQDCHPID option controls which IQD CHPID (and related
subchannel devices) VTAM selects
to dynamically build the iQDIO (IUTIQDIO) MPC group. The IUTIQDIO
MPC group is used for TCP/IP dynamic XCF communications within System z®. Although
this option can be modified (and the modification will immediately
be displayed) while the IUTIQDIO MPC group is currently active, any
modifications have the effects shown in the section called IQD CHPID
modifications in z/OS Communications Server: SNA Operation.
- Because of the volume of messages that can be generated, it is
not recommended that this option be enabled during normal operation.
Instead, it is recommended that this option be enabled (using the
MODIFY VTAMOPTS command) on all necessary hosts only when trying to
diagnose specific problems. After the problem has been diagnosed or
documentation has been collected, this option should be disabled once
again (using the MODIFY VTAMOPTS command).
- MAXLOCAT can be modified only if NODETYPE was specified during
VTAM START processing.
- The option does not take effect for MPC groups that are in
the process of being activated when the command is issued until those
MPC groups are deactivated and reactivated.
- MULTPATH is meaningful only if the NODETYPE start option
is also specified.
- NNSPREF can be modified only if NODETYPE=EN was specified
during VTAM START processing.
- NUMTREES can be modified only if NODETYPE=NN was specified
during VTAM START processing.
- OSIEVENT=PATTERNS is not valid when OSIMGMT=YES.
- OSITOPO=ALLCDRSC is not valid when OSIMGMT=YES.
- PMTUD is meaningful only if the NODETYPE start option is
also specified.
- RESUSAGE can be modified only if NODETYPE=NN was specified
during VTAM START processing.
- ROUTERES can be modified only if NODETYPE=NN was specified
during VTAM START processing.
- SNVC can be modified only if BN=YES was specified during
VTAM START processing.
- SORDER can be modified only if VTAM has been started as an
interchange node or a migration data host.
- SRCOUNT is meaningful only when SRCHRED=ON.
- SRTIMER is meaningful only when SRCHRED=ON.
- SSEARCH can be modified only if NODETYPE=NN was specified
during VTAM START processing.
- TCPNAME can be modified only if NODETYPE was specified during
VTAM START processing. The new value will not be used until all lines
in the XCA major node used for Enterprise Extender are inactive. However,
displays of VTAM start options will show the new value immediately.
Any subsequent line activation from the Enterprise Extender XCA major
node will make use of the new TCPNAME value.
- TDUDIAG is meaningful only if the NODETYPE=NN start option
is also available.
- UNRCHTIM is meaningful only if the NODETYPE start option
is also used.
- VFYREDTI can be modified only if NODETYPE=NN was specified
during VTAM START processing.
- VRTG can be modified only if NODETYPE and HOSTSA are specified.
- VRTGCPCP can be modified only if NODETYPE and HOSTSA are
specified.