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 “Control Operator Intrinsics” lists the control operator intrinsics
and their functions.
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. |
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.
- >0
Execution was successful, but a warning condition
was encountered. The positive value corresponds to a warning message
in set 11 of the APPC message catalog, CATAPPC.APPC.SYS. APPC subsystem warning messages are followed
by (APPCWARN xxxx), where xxxx is the message number.
The subsystem field (bits 16-31) may contain the
following values:
- 0
The intrinsic executed successfully and there are
no messages.
- 732
The message in the information field was generated
by the APPC subsystem.
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.
