 |
» |
|
|
|
Controls the number of active sessions of a specified APPC
session type. Syntax | |
CA I16V I32
APPCSessions (SessionType, NewLimit, ReturnCode) |
Parameters | |
- SessionType
Required. Character array;
input. The name of the session type whose session limit you want
to change. This must be a session type name configured in the APPC
subsystem configuration file. SessionType is an 8-character ASCII array, left justified and padded
with blanks. - NewLimit
Required. 16-bit signed integer;
input. The new session limit for the active session type you specified
in the SessionType parameter. The following restrictions apply to the new session limit: The new session limit for the specified session
type may not exceed the Maximum Number of Sessions value configured for the session type. To find
out the Maximum Number of Sessions value for a session type, issue the APPCCONTROL STATUS command, described in Chapter 2 “Interactive Control Operator Commands” See Chapter 4 “APPC Subsystem Configuration” for information on session type configuration. The total number of simultaneously active sessions, for
all LU 6.2 products using the APPC subsystem, may not exceed
256.
- ReturnCode
Required. 32-bit signed integer;
output. Indicates the result of the intrinsic execution. The
ReturnCode consists of two 16-bit fields: an information field, containing
the number of an APPC warning or error message, and a subsystem
field, containing the number of the subsystem that generated the
message. If both fields contain zeros, the intrinsic executed successfully, and
there are no messages. For more information, see "Return
Codes" at the beginning of this chapter. Appendix A “Messages” contains a list of all return codes returned by the
APPC subsystem, their causes, 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. 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 |
|
