HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Architected Interface Facility: Operating System Reference Manual > Chapter 3 Architected Interface Descriptions

AIFJSGET

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Returns job and/or session information.

Syntax

               REC             I32A          @64A           RECA

AIFJSGET (overall_status, itemnum_array, item_array, itemstatus_array,

            REC    I32    I32

          JSNum, JSKey, user_id);

Parameters

overall_status

record by reference (required)

Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not specific to any particular item. A positive value indicates the last element in itemstatus_array, signaling an error condition. Refer to appendix A for meanings of status values.

Record type: status_type (Refer to appendix B.)

itemnum_array

32-bit signed integer array by reference (required)

An array of integers where each element is an item number indicating the information to be returned to a data structure pointed to in the corresponding element in item_array. If n item numbers are being requested, element n+1 must be a zero to indicate the end of the element list.

item_array

64-bit address array by reference (required)

An array where each element is a 64-bit address pointing to a data structure where information is returned. Information and its required data type are defined by the item number passed in the corresponding element in itemnum_array.

Array type: globalanyptr

itemstatus_array

record array by reference (required)

An array where each element returns the status of the operation performed in the corresponding element in item_array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values.

Array type: status_type (Refer to appendix B.)

JSNum

record by value (optional)

Passes the job/session number of the job or session for which information is desired.

Record type: jsnum_type (Refer to appendix B.)

Default: 0

JSKey

32-bit signed integer by value (optional)

Passes the job/session key returned from a call to AIFSYSWIDEGET. Accessing information using this key is faster than when using the job/session number.

Default: 0

user_id

32-bit signed integer by value (optional)

The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON.

Default: 0

Operation Notes

AIFJSGET accepts as an input key either of the following:

  • A job/session number

  • A job/session key returned from AIFSYSWIDEGET

Use of a job/session key provides much faster access than a job/session number. If neither parameter is specified, the default is the caller's job/session.

Feedback to webmaster