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

Chapter 3 61
Control Operator Intrinsics
APPCSessions
APPCSessions
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:
1. 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.
2. 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,