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

59
3 Control Operator Intrinsics
Control operator intrinsics are subroutines that you can call from
inside programs written in COBOL II, Pascal, C, or Transact. They
have the same functions as the interactive control operator commands
described in Chapter 2 , “Interactive Control Operator Commands.”
You must have Node Manager (NM) capability to call control operator
intrinsics. You must declare intrinsics with the keyword INTRINSIC.
(See the appropriate HP language reference manual for more
information on declaring and calling HP intrinsics.)
Table 3-1 lists the control operator intrinsics and their functions.
This chapter describes the control operator intrinsics, in alphabetical
order. Data types are listed above the parameters, abbreviated as
follows:
I32 32-bit signed integer, passed by reference
I16V 16-bit signed integer, passed by value
CA character array
Output parameters are underlined. Optional parameters are enclosed
in square brackets.
Return Codes The
ReturnCode parameter, a 32-bit integer passed by reference, is
required in all intrinsic calls. It consists of two 16-bit fields: an
information field and a subsystem field.
The information field (bits 0–15) may contain the following values:
0 The intrinsic executed successfully and there are no
messages.
<0 Execution was unsuccessful. The negative value
corresponds to an error message in set 10 of the APPC
message catalog, CATAPPC.APPC.SYS. APPC
subsystem error messages are followed by
(APPCERR
xxxx ) is the message number.
Table 3-1 Control Operator Intrinsics
APPCSessions
Controls the number of active sessions of a specified APPC session
type.
APPCStart
Starts up the APPC subsystem and all APPC sessions configured
for automatic activation.
APPCStatus
Indicates whether the APPC subsystem is active.
APPCStop
Shuts down the APPC subsystem and all active APPC sessions.