MODIFY ALSLIST command


Add an entry to an adjacent link station list:

>>-MODIFY-- --procname--,--ALSLIST--,--ACTION--=--ADD----------->

>--,--ID--=--+-*----------------+------------------------------->
             +-cdrsc_major_node-+   
             '-cdrsc_name-------'   

>--,--NEWALS--=--adjacent_link_station_name--------------------><


Delete an entry from an adjacent link station list:

>>-MODIFY-- --procname--,--ALSLIST--,--ACTION--=--DELETE-------->

>--,--ID--=--+-*----------------+------------------------------->
             +-cdrsc_major_node-+   
             '-cdrsc_name-------'   

>--,--OLDALS--=--adjacent_link_station_name--------------------><


Replace an entry in an adjacent link station list:

>>-MODIFY-- --procname--,--ALSLIST--,--ACTION--=--REPLACE------->

>--,--ID--=--+-*----------------+------------------------------->
             +-cdrsc_major_node-+   
             '-cdrsc_name-------'   

>--,--NEWALS--=--adjacent_link_station_name--------------------->

>--,--OLDALS--=--adjacent_link_station_name--------------------><


Create a clone CDRSC or a dynamic CDRSC and add entry in adjacent link station list:

>>-MODIFY-- --procname--,--ALSLIST--,--ACTION--=--CREATE-------->

>--,--ID--=--cdrsc_name----------------------------------------->

>--,--NEWALS--=--adjacent_link_station_name--------------------><

Abbreviations

Operand	Abbreviation
MODIFY	F
ACTION=CREATE	ACTION=CRE
ACTION=DELETE	ACTION=DEL
ACTION=REPLACE	ACTION=REP
NEWALS	NEW
OLDALS	OLD

Purpose

The MODIFY ALSLIST (adjacent link station list) command enables you to create or change an entry in the default adjacent link station list for an independent LU. A change to the adjacent link station list affects only sessions established after the change is made. It does not affect active or pending active sessions.

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 create a dynamic or clone cross-domain resource, add a PU to the adjacent link station list, delete a PU from the list, or replace a PU currently named in the adjacent link station list with another PU.

ACTION=ADD

Adds a PU to the adjacent link station list for the existing independent LU specified. Specify the name of the PU on the NEWALS operand.

Tip: You can code NEWALS=ISTAPNPU instead of a real adjacent link station name. ISTAPNPU is a generic representation for any APPN-capable adjacent link station. If VTAM finds ISTAPNPU in the adjacent link station list for an independent LU, VTAM treats ISTAPNPU as if it were any active APPN-capable adjacent link station when trying to determine whether to attempt routing through the APPN network.

ACTION=CREATE

Creates a clone cross-domain resource or a dynamic cross-domain resource for the independent LU specified on the ID operand. The dynamic cross-domain resource is created only if the independent LU does not exist and a clone CDRSC cannot be created from an active model CDRSC. If the independent LU exists or if it is dynamically created (from a model CDRSC or in ISTCDRDY), the adjacent link station list for the independent LU is updated to include the specified adjacent link station (ALS).

If the specified independent LU is dynamic (that is, it was created as a dynamic cross-domain resource and ACTION=ADD or ACTION=CREATE added an ALS to the list, or ACTION=CREATE created the resource), but the ALS (PU) has DYNLU=NO specified on its definition statement, the ALS is added to the ALS list but it is not usable for sessions with the dynamically defined independent LU.

The CDRSCTI start option determines how long the newly created dynamic cross-domain resource can remain without active sessions before it is deleted. The CDRSCTI start option has no affect on newly created clone CDRSCs; they remain active until some other action on them occurs, such as a VARY INACT operator command.

Specify the name of the PU to be created on the NEWALS operand.

ACTION=DELETE

Deletes an existing PU from the adjacent link station list. Specify the name of the PU to be deleted on the OLDALS operand.

Tip: You can code OLDALS=ISTAPNPU instead of a real adjacent link station name. ISTAPNPU is a generic representation for any APPN-capable adjacent link station. If VTAM finds ISTAPNPU in the adjacent link station list for an independent LU, VTAM treats ISTAPNPU as if it were any active APPN-capable adjacent link station when trying to determine whether to attempt routing through the APPN network. This command does not delete any real PU names that are APPN-capable; it deletes only the ISTAPNPU entry.

ACTION=REPLACE

Adds a PU to the adjacent link station list and deletes an existing PU from that list. Specify the name of the PU to be added on the NEWALS operand and the name of the PU to be deleted on the OLDALS operand. Both the NEWALS and the OLDALS operands are required if ACTION=REPLACE.

Tip: You can code NEWALS=ISTAPNPU or OLDALS=ISTAPNPU instead of a real adjacent link station name. ISTAPNPU is a generic representation for any APPN-capable adjacent link station. If VTAM finds ISTAPNPU in the adjacent link station list for an independent LU, VTAM treats ISTAPNPU as if it were any APPN-capable adjacent link station when trying to determine whether to attempt routing through the APPN network.

ID

Specifies the cross-domain resources that are to be changed.

ID=cdrsc_major_node: Specifies that this command applies to all cross-domain resources that apply to that major node.
ID=cdrsc_name: Specifies that this command applies to the specified cross-domain resource (independent LU) that is to be created or changed. You can specify a network-qualified name for the independent LU.
Tip: If you are specifying a model 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.

Restriction: A model CDRSC cannot be specified when ACTION=CREATE is specified.
ID=*: Specifies that this command applies to all cross-domain resources.

NEWALS=adjacent_link_station_name

Specifies the name of the new adjacent link station (PU) for the independent LU specified. You use this operand to add a PU or to identify a new PU that will replace an existing one in the adjacent link station list.

OLDALS=adjacent_link_station_name

Specifies the name of the existing adjacent link station (PU) for the independent LU specified. You use this operand to delete a PU or to identify an existing PU that is to be replaced by another PU in the adjacent link station list.