APPC Subsystem on MPE/XL Node Manager's Guide (30294-90007)

62 Chapter3
Control Operator Intrinsics
APPCSessions
and the actions you should take to resolve any
problems.
Description
The APPCSessions intrinsic changes the number of active sessions for a
specified session type. The new session limit for the session type is in
effect only while the APPC subsystem is currently active; the
APPCSessions intrinsic does not update the APPC configuration file.
When you call the APPCSessions intrinsic to raise the session limits for
a session type, sessions will be activated until the new session limit is
reached.
Using the APPCSessions intrinsic to reduce the session limit for a
session type causes an orderly termination of the sessions affected;
termination will not occur until conversations on the affected sessions
have ended. All current conversations for the affected sessions are
allowed to complete, but no new conversations are allocated for those
sessions.
NOTE If you are changing the session limit for an independent LU running
parallel sessions, the new limit will be negotiated with the partner LU
on the remote system. Therefore, the actual new limit might not agree
with the limit you requested in your APPCSessions intrinsic call.
To find out the actual, negotiated session limit, issue the APPCCONTROL
STATUS command, described in Chapter 2 , “Interactive Control
Operator Commands.”
For dependent LUs and independent LUs running single sessions, the
new value is not negotiated.
The APPCSessions intrinsic performs the same function as the control
operator command APPCCONTROL SESSIONS.
Return Codes
0 = Successful completion
-1001 = Missing required parameter
-1002 = Parameter error
-1003 = Parameter string length too long
-1004 = Too many parameters specified
-1005 = Syntax error
-1006 = Redundant parameter
-1007 = Missing parameter after equal sign
-1008 = Missing or invalid delimiter
-1009 = Parameter out of bounds
-1010 = User missing NM capability
-1015 = Invalid SessionTypeName parm value
-1016 = Invalid SessionLimit parm value
-1063 = Resource Manager error - CHANGE_SESSIONS_FAILED
-1065 = Control Operator internal error
-1072 = APPC subsystem not active
-1075 = APPC subsystem shutting down
-1201 = Session limit exceeded