>>-+-/ASSIGN-+--------------------------------------------------> '-/ASS----' .------. .------. V | V | >--+---CLASS----cls#-+--+----+--REGION----reg#-+------------+-->< | '-TO-' | | .----------. | | V | | +---CPRI--cpri#--+----+--TRAN----tranname-+--------------+ | '-TO-' | +-INPUT--LTERM--ltermname--+----+--| A |-----------------+ | '-TO-' | | .----------. | | V | | +-+-LCT--lct#---+--+----+--TRAN----tranname-+------------+ | '-LPRI--lpri#-' '-TO-' | +-LTERM--+-ltermname--+----+--| B |-+--------------------+ | | '-TO-' | | | '-PRIMARY--| C |-----------' | | .----------. | | V | | +-NPRI--npri#--+----+--TRAN----tranname-+----------------+ | '-TO-' | +-OUTPUT--LTERM--ltermname--+----+--| D |----------------+ | '-TO-' | | .----------. | | V | | +-+-PARLIM--parlim#-+--+----+--TRAN----tranname-+--------+ | +-PLCT--plct#-----+ '-TO-' | | +-SEGNO--seg#-----+ | | '-SEGSZ--segsz#---' | | .----------. | | V | | +---TRAN----tranname-+--+----+--CLASS--cls#--------------+ | '-TO-' | '-USER--username--+----+--+-USER--username--+--------+-+-' '-TO-' | +-SAVE---+ | | '-NOSAVE-' | '-VTAMPOOL-------------------' A: |--LINE--line#--PTERM--pterm#--+---------------------+----------| '-ICOMPONENT--icompt#-' B: |--+-LINE--line#--PTERM--pterm#--| E |--| F |-+-----------------| +-LTERM--ltermname-------------------------+ +-NODE--nodename--| F |--------------------+ '-USER--username--| F |--+--------+--------' +-SAVE---+ '-NOSAVE-'
C: |--+-LINE--line#--PTERM--pterm#-+-------------------------------| '-NODE--nodename-------------' D: |--LINE--line#--PTERM--pterm#--+-------------------+------------| '-COMPONENT--compt#-' E: |--+----------------------------+-------------------------------| +-LINE--line#--PTERM--pterm#-+ '-PTERM--pterm#--------------' F: |--+---------------------+--+-------------------+---------------| '-ICOMPONENT--icompt#-' '-COMPONENT--compt#-'
Table 17 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/ASSIGN | X | X | |
CLASS | X | X | |
COMPONENT | X | X | |
CPRI | X | X | |
ICOMPONENT | X | X | |
INPUT | X | X | |
LINE | X | X | |
LCT | X | X | |
LPRI | X | X | |
LTERM | X | X | |
NODE | X | X | |
NOSAVE | X | X | |
NPRI | X | X | |
OUTPUT | X | X | |
PARLIM | X | X | |
PLCT | X | X | |
PTERM | X | X | |
REGION | X | X | |
SAVE | X | X | |
SEGNO | X | X | |
SEGSZ | X | X | |
TRAN | X | X | |
USER | X | X | |
VTAMPOOL | X | X |
/ASSIGN alters the relationships between various IMS resources and resets certain values specified during IMS system definition.
Most changes made by the /ASSIGN command remain in effect until changed with another /ASSIGN command, or an IMS cold start (/NRESTART CHECKPOINT 0) is performed.
When dynamic LTERMs are assigned to dynamic users with the /ASSIGN LTERM TO USER command, or dynamic users are assigned to dynamic users with the /ASSIGN USER TO USER command, changes remain in effect only if the following conditions are true:
Otherwise, changes are lost when the destination user is deleted during user sign-off or IMS checkpoint.
Changes that affect regions, such as CLASS, are only in effect until the region terminates. For information on changing multiple systems assignments, see /MSASSIGN
Recommendation: Use the /ASSIGN command consistently on all IMS subsystems that are members of a VTAM generic resources group or share IMS queues. For example, assign an LTERM to a specific node for all IMS subsystems; assigning one LTERM to different nodes on different IMS subsystems could cause unpredictable results.
The /ASSIGN command is mirrored on an XRF alternate environment unless the assignment involves the primary or secondary master terminal, or the assignment of a CLASS to a REGION.
/ASSIGN commands attempting to assign LTERMs or users between static and dynamic terminals receive a unique error message. An error message is issued if /ASSIGN attempts any of the following
Restriction: You cannot use the /ASSIGN command to assign a user structure to a node that does not exist. Use the /OPN NODE nodename USER username command instead.
In an IMSplex, the /ASSIGN LTERM and /ASSIGN USER commands alter the relationships between one or more logical terminals and a physical terminal or user.
For static terminals in an IMSplex, the control blocks should exist in all the IMS systems where a user could possibly log on to that terminal. If /ASSIGN LTERM TO NODE is specified in an IMSplex, it should be issued from the Single Point Of Control (SPOC) application. If ROUTE is specified, it should be specified as ROUTE(*). Otherwise, the /ASSIGN command may not be processed consistently across the IMSplex and could cause unpredictable results. If one of the /ASSIGN commands fails, that IMS will send back a completion code to the Operations Manager (OM) indicating failure. It will be up to the IMS installation to correct that problem.
/ASSIGN LTERM TO NODE assigns the input and output capabilities of a logical terminal to a static VTAM node. The logical terminal may not be in conversational, response, or preset destination mode. The source and destination terminals do not need to be stopped or logged off.
If global resource information is not kept in the Resource Manager (RM) and the node exists locally, this command applies locally. If global resource information is kept in RM, this command applies globally, if the control blocks exist in RM. However, the assignment changes are not considered significant, and if the resource is deleted, the assignment changes are deleted as well. An LTERM that exists in the RM could be deleted if the static node to which it is assigned does not exist in the RM. If NODEA and LTERMA exist in the RM because the node is in exclusive mode, but static NODEB is not in RM, an /ASSIGN LTERM LTERMA NODE NODEB command would result in LTERMA being deleted in RM.
The IMS where the LTERM and node are active, or the command master if the resources are not active, will make the changes in the RM. In this case, "active" includes the case where the terminal is logged off, but has an RM affinity to a particular IMS. For /ASSIGN LTERM TO NODE, the LTERM and node might not be active in different IMSs.
When the log on of a static node attempts to write its LTERM names to the RM, but one or more of the LTERM names are already in use, IMS will reject the log on. This error should occur only if there are inconsistent definitions, or there have been inconsistent /ASSIGN commands issued in the IMSplex.
/ASSIGN LTERM TO USER assigns the input and output capabilities of an ETO logical terminal to an ETO user or a static ISC logical terminal to a static ISC subpool. The logical terminal may not be in conversational, response, or preset destination mode. The source user associated with the ETO LTERM might not be signed on. The destination ETO user does not have to be stopped. If global resource information is not kept in RM and the user exists locally, this command applies locally. If global resource information is kept in RM, this command applies globally (if the control blocks exist in RM). However, the assignment changes are not considered significant, and if the resource is deleted, the assignment changes are deleted as well. The IMS where the LTERM and node are active, or the command master if the resources are not active, will make the changes in the RM.
Use /ASSIGN LTERM TO USER with the SAVE keyword in an RM environment, to cause the assignment to persist and to apply the change to future IMSs that join the IMSplex. The SAVE keyword is valid only for dynamic terminals, so this persistence function is not available for static terminals. Use /ASSIGN LTERM TO USER with the NOSAVE keyword in an RM environment, to stop applying the change to future IMSs that join the IMSplex.
/ASSIGN USER TO USER assigns all the logical terminals associated with the source user to the destination user. The destination user, if dynamic, does not have to be stopped. If global resource information is not kept in RM and the user exists locally, this command applies locally. If global resource information is kept in RM, this command applies globally. Use /ASSIGN USER TO USER with the SAVE keyword in an RM environment to cause the assignment to persist and to apply the change to future IMSs that join the IMSplex. The SAVE keyword is valid only for dynamic terminals, so this persistence function is not available for static terminals. Use /ASSIGN USER TO USER with the NOSAVE keyword in an RM environment to stop applying the change to future IMSs that join the IMSplex.
The /ASSIGN command is allowed when the destination user does not exist. However, when resource information is being kept in RM, unless the SAVE keyword is used, this command will not be allowed. Assignments are not considered significant without the SAVE keyword, and if the user doesn't already exist due to some other significant status, there is no reason to create the user.
IMS will dynamically create the source LTERM or user (if it does not exist) to enable the /ASSIGN command. If the destination also does not exist, the SAVE keyword must be specified on the /ASSIGN command. Otherwise, the SAVE keyword is optional.
IMS supports the assignment of an LTERM between BTAM and VTAM terminals. However, IMS will not save any BTAM status. For example, if an LTERM is assigned from VTAM to BTAM, the LTERM will be deleted from the RM, and any status that might have been associated with that LTERM will no longer be recoverable.
|The /ASSIGN CLASS cls# (TO) REGION reg# command can include up to four class parameters and replaces |the class values that existed previously. Valid class parameters |are numeric values from 1 to 999.
For static transactions, the CLASS parameter (cls#) is initially set by system definition using the TRANSACT macro statement. For CPI communications driven transactions, the initial value is obtained from the TP profile. For more information on the CPI Communications interface transactions, see IMS Version 9: Administration Guide: Transaction Manager.
Table 18 shows the relationships between COMPONENT values and terminals. The first column lists the terminal, the second and third columns list the COMPONENT parameters that can have values of 1, 2, 3, or 4.
No response is sent to a terminal referenced in an /ASSIGN command. The logical terminal must not be an inquiry logical terminal and must not have queueing or dequeuing of messages in progress.
LTERMs created dynamically can be assigned to dynamically created users. Static logical terminals can be assigned to other static terminals. Dynamic logical terminals cannot be assigned to lines, static nodes, dynamic nodes, or static users. Static logical terminals cannot be assigned to dynamic nodes or users. /ASSIGN commands that split the logical terminal so that the input LTERM is associated with one node and the output is associated with another node are not allowed for any ACF/VTAM terminals.
MSGDEL processing for an LTERM is based on how the MSGDEL option was defined:
When a 3270 is designated as the master terminal during IMS system definition, two master logical terminals are generated. One, referred to as the primary master terminal, must be assigned to a 3270 display (3275/3276/3278/3279) for all input and output messages. The other, referred to as the secondary master terminal, must be assigned to a 3270 printer (3284/3286/3287/3288/3289) for certain IMS-selected output messages.
To move a single master logical terminal from one physical terminal to another physical terminal (for example, the secondary master from one 3284 to another 3284, or the primary master from one 3277 to another 3277) without moving the other, use the formats of /ASSIGN LTERM command with one LINE/PTERM or NODE, and specify the LTERM name of the master terminal.
You can use either of the following commands:
This command format assigns both the input and output of the primary master terminal to LINE line#1 PTERM pterm#1, and both the input and output of the secondary master terminal to NODE nodename.
This command format assigns the input and output of the primary master terminal to the LINE line#1 PTERM pterm#1/NODE nodename #1 and assigns the input and output of the secondary terminal to LINE line#2 PTERM#2/NODE nodename#2.
These two formats can reassign:
The first LINE/PTERM or NODE specifies the display device to which the primary master logical terminal is to be assigned. The second LINE/PTERM or NODE specifies the printer device to which both the input and output capabilities of the secondary are to be assigned. If only one LINE/PTERM or NODE is specified, then the input and output capabilities of the primary master logical terminal and the secondary master logical terminal are assigned to the same LINE/PTERM or NODE.
For a description of logical terminals (LTERMs), see IMS Version 9: Administration Guide: System. The command formats used with the /ASSIGN LTERM ltermname command are:
This command format assigns the input and output capabilities of the logical terminal to LINE line#1 PTERM pterm#1. This command is not valid if the LTERM is dynamic.
/ASSIGN LTERM ltermname [TO] LINE line#1 PTERM pterm#1 LINE line#2 PTERM pterm#2
This command format assigns the input capability of the logical terminal to the first LINE/PTERM pair and assigns the output capability of the logical terminal to the second LINE/PTERM pair. This command is not valid if the LTERM is dynamic.
This command format assigns the input capability of the logical terminal to LINE line#1 PTERM pterm#1 and assigns the output capability of the logical terminal to the same LINE, line#1, but to a different PTERM, pterm#2. This command is not valid if the LTERM is dynamic.
This command format assigns the input and output capabilities of the logical terminal to NODE nodename. This command is not valid if the LTERM or NODE is dynamic.
This command format allows an input chain to be moved to a symbolic location, rather than to a specific line and physical terminal. The [TO] line and terminal are determined by the current assignment of the specified [TO] logical terminal. With this format, the output assignment is not affected. This form of the /ASSIGN command is invalid for ISC nodes defined for parallel sessions, and it is not supported for LTERMs associated with VTAM terminals.
This command format assigns the logical terminal to the given user. When moving logical terminals between users, the MSGDEL options of the users as defined during system definition or on user descriptor must match. The user related to LTERM ltermname must not be signed on in conversation, in response mode, or in preset mode. For 3600/FINANCE, SLU P, and ISC, the user (username) can remain allocated due to terminal message resynchronization requirements. However, the user cannot be signed on because the associated terminal session must be stopped and idle. The user can be allocated, but, if allocated, must be associated with a session that is stopped and idle. This command will turn off the DEADQ status for the user associated with LTERM ltermname.
/ASSIGN PARLIM is not valid for CPI Communications driven transactions.
/ASSIGN PLCT is not valid for CPI Communications driven transaction programs.
/ASSIGN SEGNO is not valid for CPI Communications driven transaction programs.
/ASSIGN SEGSZ is not valid for CPI Communications driven transaction programs.
/ASSIGN LTERM ltermname (TO) USER username assigns the logical terminal to another USER. The user associated with LTERM ltermname must not be allocated. The USER username can be allocated, but it must be associated with a session that is stopped and idle, if allocated.
If SAVE is specified, the dynamic user is not deleted unless another /ASSIGN command with the NOSAVE keyword is issued.
/ASSIGN USER username1 (TO) USER username2 assigns a string of logical terminals to another USER The first user (username1) in the command must contain at least one logical terminal and must not be signed on, in conversation, in response mode, or in preset mode. For 3600/FINANCE, SLU P, and ISC, the second user (username2) can remain allocated due to terminal message resynchronization requirements. However, the user cannot be signed on and associated terminal sessions must be stopped and idle. This command turns off the DEADQ status for USER username1.
In addition to the ISC rules and restrictions, following dynamic terminal restrictions also apply. The /ASSIGN USER to USER and /ASSIGN LTERM to USER commands are rejected if the source or destination dynamic user is in conversation mode, response mode, or preset mode. The second USER can be allocated, but it must be associated with a session that is stopped and idle, if allocated.
When existing dynamic LTERMs or dynamic users are assigned to a destination user that doesn't exist, the destination user is created unless it is rejected by the DFSINSX0 user exit.
/ASSIGN VTAMPOOL deallocates an entire string of logical terminals allocated to a given USER. The user must not be signed on, in conversation mode, response mode, or preset mode, and the terminal must be stopped and idle. This command is valid for static and dynamic ISC users.
Entry ET:
/ASSIGN CLASS 5 TO REGION 3
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Class 5 is assigned to region 3. Class 5 transactions are scheduled into region 3. This command resets any previous class assignments to this region.
Entry ET:
/ASSIGN CLASS 4 6 2A TO REGION 5
Response ET:
DFS058I ASSIGN COMMAND COMPLETED EXCEPT CLASS 2A
Explanation: The requested assignment is complete except for 2A, which is an invalid class number.
Entry ET:
/ASSIGN CPRI 8 TO TRANSACTION PIT, SEED
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: A current priority of 8 is set for the transactions named PIT and SEED.
Entry ET:
/ASSIGN INPUT LTERM JONES TO LINE 4 PTERM 3
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal JONES is assigned to LINE 4 PTERM 3 for input identification and security. It associates the chain of logical terminals, of which LTERM JONES will be chained in first, with LINE 4 PTERM 3 for input. LTERM JONES must not be in the interior of an input chain (no other logical terminal can point to it). A physical terminal can point (for input only) to the first logical terminal of any chain. The output physical terminal for LTERM JONES is not changed.
Entry ET:
/ASSIGN LTERM APPLE TO LINE 5 PTERM 1
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal APPLE has both its input and output capabilities assigned to LINE 5 PTERM 1. The components present on LINE 5 PTERM 1 must be compatible with the physical terminal previously related to logical terminal APPLE.
Entry ET:
/ASSIGN LTERM APPLE TO NODE JONES
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal APPLE has both its input and output capabilities assigned to node JONES. The components present on node JONES must be compatible with the physical terminal previously related to logical terminal APPLE.
Entry ET:
/ASSIGN LTERM SMITH TO LINE 4 PTERM 6 PTERM 7 COMPONENT 2
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal SMITH is assigned to LINE 4 PTERM 6 for input and LINE 4 PTERM 7 for output. Output for LINE 4 PTERM 7 is directed to COMPONENT 2.
Entry ET:
/ASSIGN LTERM X TO LINE 5 PTERM 7 PTERM 6 COMPONENT 4 ICOMPONENT 3
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal X is assigned to LINE 5 PTERM 7 for input and to LINE 5 PTERM 6 for output. Input is only received from input component 3, while output is directed to component 4.
Entry ET:
/ASSIGN LTERM JONES TO LINE 4 PTERM 6 LINE 9 PTERM 1
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal JONES is assigned to LINE 4 PTERM 6 for input capability and LINE 9 PTERM 1 for output capability. The component assignment is unaffected.
Entry ET:
/ASSIGN LTERM SMITH NODE JONES
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal SMITH is assigned to node JONES for both input and output.
Entry ET:
/ASSIGN LTERM BROWN TO LTERM WHITE
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal BROWN is removed from its present input chain (if one exists) of logical terminals and added to the end of the input chain (if one exists) of logical terminal WHITE. The output physical terminal for LTERM BROWN is not changed.
Entry ET:
/ASSIGN LTERM LAX USER ILL ICOMPONENT 1 COMPONENT 2
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: Logical terminal LAX is reassigned from its existing user to the user ILL. The user associated with LAX cannot be allocated to an active session.
Entry ET:
/ASSIGN LTERM PRIMARY TO LINE 4 PTERM 3
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: PTERM 3 on LINE 4 becomes the master terminal. PTERM 3 must be a 3270 display.
Entry ET:
/ASSIGN LTERM PRIMARY TO NODE BOSS
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: The node, BOSS, becomes the primary master terminal and the secondary master terminal.
Entry ET:
/ASSIGN LTERM PRIMARY TO LINE 1 PTERM 2 LINE 2 PTERM 4
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: PTERM 2 on LINE 1 becomes the primary master terminal and PTERM 4 on LINE 2 becomes the secondary master terminal. PTERM 2 is a 3270 display station and PTERM 4 is a 3270 printer.
Entry ET:
/ASSIGN SEGNO 50 TO TRANSACTION APPLE
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: A limit of 50 output segments is set for the transaction APPLE.
Entry ET:
/ASSIGN SEGSZ 1000 TO TRANSACTION APPLE
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: A maximum size of 1000 bytes is set for any one output segment of transaction APPLE.
Entry ET:
/ASSIGN USER ILL TO USER CAL
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: All the logical terminals of user ILL are appended to the existing LTERM string of user CAL. Use of this form of the /ASSIGN command leaves ILL with no LTERMs and therefore unavailable for allocation to a session. Both user ILL and CAL cannot be allocated to a session.
Entry ET:
/ASSIGN USER CAL TO VTAMPOOL
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: The entire allocated LTERM string defined for user CAL is reassigned to the VTAM pool. The node to which user CAL is allocated must not be in session and must be stopped and idle. User CAL is then available for allocation to any ISC session.
Entry ET:
/ASSIGN TRAN APPLE TO CLASS 5
Response ET:
DFS058I ASSIGN COMMAND COMPLETED
Explanation: The transaction named APPLE is assigned to class 5.