MODIFY RESOURCE command


Modify the DLOGMOD value for a resource:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--DLOGMOD--=--+-----------------+--------------------------><
                  '-logon_mode_name-'


Add or change the ADJLIST value for a cross-domain resource:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--ADJLIST--=--list_name--,--ACTION--=--UPDATE--------------><


Delete the ADJLIST value for a cross-domain resource:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--ADJLIST--=--list_name--,--ACTION--=--DELETE--------------><


Change the error message display option for an APPL or CDRSC:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--SIRFMSG--=--+-OLUSSCP--+---------------------------------><
                  +-ALLSSCP--+   
                  +-STARTOPT-+   
                  '-NONE-----'


Change the delay timer for disconnection of a switched PU:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--DISCNTIM--=--time_period---------------------------------><


Change the number of search requests for a resource:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--SRCOUNT--=--number_of_search_requests--------------------><


Change the value of the search reduction timer for a resource:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--SRTIMER--=--number_of_seconds----------------------------><


Reset the search reduction entry for a resource:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--SRCLEAR--=--YES------------------------------------------><


Modify the registration value for a resource:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--REGISTER--=--+-CDSERVR-+---------------------------------><
                   +-NETSRVR-+   
                   '-NO------'


Modify the ASRCVLM value for an application program:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--ASRCVLM--=--amount_of_storage----------------------------><


Modify the MODSRCH value for a model application program:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--MODSRCH--=--+-FIRST-+------------------------------------><
                  +-LAST--+   
                  '-NEVER-'


Modify the VTAMTOPO value for a reporting status:

>>-MODIFY-- --procname--,--RESOURCE--,--ID--=--resource_name---->

>--,--VTAMTOPO--=--+-REPORT---+--------------------------------><
                   +-NOREPORT-+   
                   +-NOLLINES-+   
                   +-NOSWPUS--+   
                   +-INCLUDE--+   
                   '-IGNORE---'

Abbreviations

Operand	Abbreviation
MODIFY	F
DLOGMOD	DLOG

Purpose

Using the MODIFY RESOURCE command, you can make perform the following changes for an individual resource:

Change the current value of the DLOGMOD operand of a definition statement for an LU, application program, or cross-domain resource without deactivating the entire major node.
Modify the reporting status for a resource.
Add, replace, or delete the current value of the ADJLIST operand of a definition statement for a cross-domain resource.
Change the setting of the error message display value for an APPL or CDRSC resource.
Change the delay timer for disconnection of a switched PU.
Modify search reduction information for existing CDRSCs and APPN directory entries.
Modify the registration value for a resource.
Change the current value of the ASRCVLM operand coded on the APPL definition statement.
Change the current value of the MODSRCH operand coded on the APPL definition statement.

When VTAM® receives the MODIFY RESOURCE command, it overlays the existing value for the specified operand with the new value.

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.

ACTION

Specifies whether VTAM is to add, update, or delete the name of the adjacent SSCP list for a cross-domain resource.

ACTION is valid only with the ADJLIST and ID operands.

ACTION=DELETE: Deletes the name of the current adjacent CDRM list for the cross-domain resource specified on the ID operand. Routing after the successful completion of this command will not use ADJLISTs. Existing sessions are not affected by this command.
ACTION=UPDATE: Adds a name of an adjacent CDRM list or replaces the name of the current adjacent CDRM list for the cross-domain resource specified on the ID operand. Routing after the successful completion of this command will use the specified list.

ADJLIST=list_name

Specifies the value of the adjacent CDRM list for the cross-domain resource specified on the ID operand. If ACTION=UPDATE, the list_name must match the name on an ADJLIST definition statement for subsequent routing to be successful.

Note: The ADJLIST operand is not valid in a pure APPN node. The MODIFY RESOURCE command will fail with an indication that ADJLIST is ignored. A pure APPN node is a VTAM that is started with start options NODETYPE=NN or NODETYPE=EN, but without HOSTSA or with HOSTSA and SACONNS=NO.

ADJLIST is valid only with the ACTION and ID operands.

ASRCVLM=amount_of_storage

Specifies an amount of the data space storage associated with this application that is used by VTAM to calculate constrained and critical threshold values for the data space. These constrained and critical threshold values affect the way adaptive session pacing operates with session partners. High usage periods of data space storage should be considered when setting this value.

The range is 0–99 999 999. If you specify 0, the amount of data space storage used is 1 000 000 bytes.

DISCNTIM=time_period

Specifies the amount of time that VTAM delays deactivation of the SSCP-PU session when there are no outstanding LU-LU session requests.

You can specify the time in seconds (S). Specify the number of seconds as an integer in the range 5–65535.

DISCNTIM is valid only for PU types 2 and 2.1 that have DISCNT=DELAY specified on the PU definition statement.

DISCNTIM is valid only with the ID operand.

DLOGMOD=logon_mode_name

Specifies the new value for the logon mode. If DLOGMOD is specified with a null value (left blank), the predefined DLOGMOD value is deleted.

DLOGMOD is valid only with the ID operand

Note: If DLOGMOD is specified with an unknown logon mode, a warning message is issued indicating that it is unknown and the change is accepted.

ID=resource_name

Specifies the name of the resource to which the command applies. If you specify ADJLIST, the resource name must specify a cross-domain resource.

Tip: If you are specifying a model resource (APPL or CDRSC), you can use wildcard characters in the name you specify. The use of wildcard characters on the ID operand does not depend on the value of the DSPLYWLD start option.

The name can be a network-qualified name. If the name specified on the ID operand is network-qualified, this name is considered to be the real name of the resource.

Note: If the resource name is a cross-network CDRSC which is defined with NQNMODE=NQNAME (either by definition statement or start option), be sure to use its network-qualified name on this command.

MODSRCH

Specifies when the INQUIRE APPSTAT and INQUIRE STATUS macroinstructions will use this model application definition. The VTAM containing the application that issued the INQUIRE first searches its tables for a previously defined application. If one is not found, it searches for a local model that can satisfy the request.

Requirement: If you plan to use the model application program definitions with TSO/VTAM, then you must code MODSRCH=FIRST on the TSO application definition statement that represents the subordinate TSO APPLs. For more information about MODSRCH, see z/OS Communications Server: SNA Network Implementation Guide.

MODSRCH=FIRST: Specifies that VTAM should use this model, if it is an appropriate match, and not search the network for the specified name. For example, because the OPEN ACB macroinstruction can use a model definition, you could specify MODSRCH=FIRST so this model would be found by an application issuing INQUIRE APPSTAT to determine whether an OPEN ACB will follow.
MODSRCH=LAST: Specifies that VTAM use this model definition only if all other hosts in the network report that the application was not found.
MODSRCH=NEVER: Specifies that VTAM never use this model to satisfy an INQUIRE macroinstruction.

REGISTER

Indicates that the registration value of the resource should be changed and a registration request might be initiated. This command can be issued only from the resource's real or surrogate owner.

REGISTER=CDSERVR: Specifies that the resource is to be registered to the network node server and the central directory server (CDS).
REGISTER=NETSRVR: Specifies that the resource is to be registered to its network node server only. If the resource is currently registered to the central directory server, the registration is not deleted.
REGISTER=NO: Specifies that the resource should not be registered. If the resource is currently registered to a network node server, a request to delete the registration is sent to the network node server. If the resource is currently registered to the central directory server, the registration is not deleted.

SIRFMSG

Specifies SIRFMSG values for the resource.

The SIRFMSG operand for a CDRSC definition will effectively control ASIRFMSG, DSIRFMSG, ESIRFMSG, FSIRFMSG, LSIRFMSG, RSIRFMSG, and SIRFMSG processing.

SIRFMSG=ALLSSCP: Specifies that messages are issued for all session initiation request failures involving this resource.
SIRFMSG=OLUSSCP: Specifies that messages are issued only when the VTAM owning this resource is the origin logical unit (OLU) SSCP.
SIRFMSG=START: Specifies that the value of the SIRFMSG start option is to be used for this resource. This is the default setting.
SIRFMSG=NONE: Specifies that no messages are issued for any searches involving this resource.

SRCLEAR=YES

Specifies that the search reduction entry should be reset for this resource. This operand does not affect the SRTIMER or SRCOUNT values for subsequent entries. The resource is verified when the next request is received. If the resource cannot be reached, a new search reduction entry is created.

SRCLEAR is valid only with the ID, SRCOUNT, and SRTIMER operands.

SRCOUNT=number_of_search_requests

Specifies the new number of search requests that are limited because of a search reduction entry before another search is attempted. The value for this operand is 0 – 65535.

Note: This operand applies only to existing CDRSCs and APPN directory entries.

SRCOUNT is valid only with the ID, SRCLEAR, and SRTIMER operands.

SRTIMER=number_of_seconds

Specifies the new number of seconds that a search reduction entry limits incoming search requests or session requests. The value for this operand is 0–65535.

Note: This operand applies only to existing CDRSCs and APPN directory entries.

SRTIMER is valid only with the ID, SRCLEAR, and SRCOUNT operands.

VTAMTOPO

Specifies the new reporting status for a resource. Possible values are:

VTAMTOPO=REPORT: Specifies that the VTAM topology agent reports resources.
VTAMTOPO=NOREPORT: Specifies that the VTAM topology agent does not report resources.
VTAMTOPO=NOLLINES: Specifies that the VTAM topology agent does not report switched logical lines.
VTAMTOPO=NOSWPUS: Specifies that the VTAM topology agent does not report connected switched PUs, except for those switched PUs which have VTAMTOPO=REPORT explicitly coded or specified under the switched major node.
VTAMTOPO=INCLUDE: Specifies that the VTAM topology agent reports all resources, regardless of the reporting status of the subordinate resources.
VTAMTOPO=IGNORE: Specifies that the VTAM topology agent does not report resources, regardless of the reporting status of the subordinate resources.