|
|
|
The following tables provide detailed descriptions of the item numbers
associated with system wide information.
Job/Session Criteria Item Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with job/session criteria used by
AIFSYSWIDEGET.
Table 3-38 AIFSYSWIDEGET Job or Session Criteria Item Descriptions
| Item Number |
Item Name (Data Type) Range Capability; Release First
Available Description |
| 1001 |
Job name (CA16) Range capability: No; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions whose job names equal the specified criteria
value. The 16-byte character array must contain the job name
(left-justified and padded with blanks).
A 16-character identifier given to a job or session. It is left-justified,
all capitals, and padded with blanks. All blanks represent a job or
session that does not have a job name. |
| 1002 |
Job state (I32) Range capability: No; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions with a current state equal to the specified
criteria value. Values and their meanings are as follows:
| 1 | Introduced (INTRO) |
| 2 | Executing (EXEC) |
| 3 | Terminating (TERM) |
| 4 | Suspended (SUSP) |
| 32 | Waiting (WAIT) |
| 40 | Error (ERROR) |
| 48 | Initializing (EXEC*) |
| 56 | Scheduled (SCHED) |
If a job or session is in the INIT state, there is no guarantee that any
of the values returned by AIFSYSWIDEGET are valid. |
| 1007 |
Input priority (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions whose input priorities (INPRI) equal the
specified criteria value(s). A value must be in the range 0..15. (A value
of 15 is equivalent to using the ;HIPRI option of the JOB
command.) When a job's input priority is higher than the system jobfence,
the system allows the job to execute.
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 1008 |
Output priority (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions whose output priorities (OUTPRI) equal
the specified criteria value(s). A value must be in the range 0..14.
When a job's output priority is higher than the outfence of the output
device, the spool file that is associated with the $STDLIST for that job
is sent to the device.
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 1009 |
User name (CA16) Range capability: No; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions logged on to the specified user. The format is a
16-byte character array containing the user name (left-justified and
padded with blanks). |
| 1010 |
Group name (CA16) Range capability: No; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions logged on to the specified group. The format is a
16-byte character array containing the group name (left-justified and
padded with blanks). Since the same group name can be used in multiple
accounts, criteria item 1011 must be specified in the following element of
the itemnum_array/item_array
pair. |
| 1011 |
Account name (CA16) Range capability: No; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions logged on to the specified account. The format is
a 16-byte character array containing the account name (left-justified and
padded with blanks). |
| 1016 |
Executing priority (I32) Range capability: No; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions logged in the specified queue. The executing
priority translates to the base of the queue that the job or session is
logged on to. Values and meanings are as follows:
| 100 | BS queue |
| 150 | CS queue |
| 200 | DS queue |
| 250 | ES queue |
|
| 1037 |
Job/session number (REC) Range capability: Yes; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of jobs/sessions whose job/session numbers equal the specified
criteria value(s).
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=).
Record type: jsnum_type (Refer to appendix B.) |
| 1039 |
Session? (B) Range capability: No; Release 3.0
Passing this criteria returns the job/session keys and/or job/session
numbers of either jobs or sessions. Values and their meanings are as
follows:
|
| 1043 |
HP DTC Portid (CA17) Put:No; Verify:Yes; Release 4.0
Returns the hpdtcportid system variable in SHOWVAR format. The format of
hpdtcportid is DTC LAN station address followed by SIC and port numbers:
0800090001111 0002. |
| 1044 |
Job submitter job/session number (REC) Put:No; Verify:Yes;
Release 4.0
Passing this criteria returns either of both of the keys and numbers for
the job or session matching the submitter job or session number. |
| 1045 |
Job submitter job/session name (CA16) Put:No; Verify:Yes;
Release 4.0
Passing this criteria returns either of both of the keys and numbers for
the job or session matching the submitter job or session name. |
| 1046 |
Job submitter user name (CA16) Put:No; Verify:Yes; Release 4.0
Passing this criteria returns either of both of the keys and numbers for
the job or session matching the submitter job or session user
name. |
| 1047 |
Job submitter account name (CA16) Put:No; Verify:Yes; Release 4.0
Passing this criteria returns either of both of the keys and numbers for
the job or session matching the submitter job or session account
name. |
Process Criteria Item Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with process criteria used by
AIFSYSWIDEGET.
Table 3-39 AIFSYSWIDEGET Process Criteria Item Descriptions
| Item Number |
Item Name (Data Type) Range capability; Release First
Available Description |
| 2015 |
Job/session number (REC) Range capability: No; Release 3.0
Passing this criteria returns the PIDs of processes related to the
specified job/session number.
Record type: jsnum_type (Refer to appendix B.) |
| 2016 |
Scheduling state (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the PIDs of processes with a process state
(as viewed by the dispatcher) equal to the specified value(s). It is the
first item that should be interrogated to ascertain a process's state.
Valid values and their meanings are as follows:
| 0 | Executing (only for Calling Process) |
| 1 | Ready |
| 2 | Short wait |
| 3 | Long wait |
| 4 | Null |
The processes in short wait and ready are linked together in the order of
priority. A short wait is basically a wait for disk I/O, and the
dispatcher expects the process to be ready in a short while.
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 2017 |
Scheduling queue (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the PIDs of processes belonging to the
specified scheduling queue(s). Valid values and their meaning are as
follows:
| 0 | AS queue |
| 1 | BS queue |
| 2 | CS queue |
| 3 | DS queue |
| 4 | ES queue |
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 2019 |
Priority (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the PIDs of processes with priority equal to
the specified criteria value(s).
MPE/iX priorities are values in the range 0..32767. An MPE/iX priority is
inverted with respect to an MPE V/E priority in that high MPE/iX priority
values indicate higher priority. The conversion to MPE V/E priority can be
accomplished as follows:
(all values are decimal)
MPEVpri = (32767 - MPEiXpri) div 128
MPE/iX priorities are very transient for user processes. For processes
whose priority is not fixed, this value is interpreted as the priority at
which the process was last dispatched. For nonconstant priority processes,
this value has no bearing on the priority at which the process is next
dispatched.
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 2033 |
Process type (I32) Range capability: No; Release 3.0
Passing this criteria returns the PIDs of processes with process type
equal to the specified criteria value. Values and their meanings are as
follows:
| 0 | User (any process created by a user) |
| 1 | Son (process created by CI to run user programs) |
| 2 | Main (CI process) |
| 3 | Task (not in use) |
| 4 | System (some integral processes) |
| 5 | Detach (not connected to the PROGEN tree) |
| 6 | UCOP (JSmain) |
| 7 | Unknown (uninitialized processes) |
|
| 2065 |
Open file (REC) Range capability: No; Release 3.0
Passing this criteria returns the PIDs of processes accessing the
specified file. Valid only for NM files.
Record type: ufid_type (Refer to appendix B.) |
| 2070 |
Capabilities (I32) Range capability: No; Release 3.0
Passing this criteria returns the PIDs of all processes that have the
specified capabilities. For example, if bit (25:1) is set to 1, PIDs of
all processes that have PM capability are returned.
| Bits(0:23) | Unused |
| Bit (23:1) | Batch access |
| Bit (24:1) | Interactive access |
| Bit (25:1) | Privileged mode |
| Bit (26:2) | Unused |
| Bit (28:1) | Multiple RINs |
| Bit (29:1) | Unused |
| Bit (30:1) | Extra data segment |
| Bit (31:1) | Process handling |
|
| 2144 |
Workgroup name (CA256) Range capability: No
Passing this criteria returns all the PIDs of the processes who are
natural or artificial members of the specified workgroup name. The
workgroup name should be terminated by a NULL character
(ASCII 0). |
File Criteria Item Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with file criteria used by
AIFSYSWIDEGET.
Table 3-40 AIFSYSWIDEGET File Criteria Item Descriptions
| Item Number |
Item Name (Data Type) Range capability; Release First
Available Description |
| 5001 |
MPE file name (REC) Range capability: No; Release 3.0
Passing this criteria returns the UFID and/or file name of all files whose
file names equal the specified criteria value. The name in each element of
the record filename_type must be left-justified and padded with
blanks. In addition, characters must be in the correct case (upper and/or
lower). Use of @'s for wild carding is permitted. @ will default to home
group and account. @.@ will default to home account. @.@.@ will get all
files.
Use item 5036 if you are interested in both MPE and HFS files. This item
can only be used for files that can be represented by MPE-semantics.
Record type: filename_type (Refer to appendix B.) |
| 5008 |
File code (I32) Range capability: No; Release 3.0
Passing this criteria returns the UFID and/or file name of all files whose
file codes match the specified criteria value. |
| 5013 |
Privileged level (I32) Range capability: No; Release 3.0
Passing this criteria returns the UFID and/or file name of all files whose
privileged level equals the specified criteria value. The valid range is
0..3 where 0 is the highest privileged level and 3 is the lowest. |
| 5036 |
HFS pathname (REC) Range capability: No; Release 4.5
Passing this criteria returns the path identifier and/or pathname of all
files whose pathname meets the specified criteria value. The pathname in
the record pathname_type must be left justified and padded with
blanks. On input, the length in the record specifies the array size in
bytes.
Pathnames will be returned into the buffer pointed to by the buffer_ptr
parameter. They will be returned as absolute or relative pathnames
depending on the syntax of the name you specify for this item. For example,
if you specify the pathname './@' on input, the names returned will be
relative to the CWD (for example, ./file). If you specify the pathname
'/SYS/PUB/@' on input, then the names returned will be absolute pathnames
(for example, /SYS/PUB/file).
Record type: pathname_type (Refer to appendix B.) |
| 5039 |
File type (U32) Range capability: No; Release 4.5
Passing this criteria returns the files (MPE filename or HFS pathname) and
unique file identifiers (UFID or path_identifier) of all files whose file
type meets the specified criteria.
The following are the file types:
0 - ordinary
1 - ksam
2 - relative_io
3 - nm_ksam
4 - circular
5 - spool
6 - message
7 - resv
8 - cmfile
9 - dir_obj
10 - label_table
11 - xm_syslog
12 - pipe
13 - fifo
14 - symbolic link
15 - device link
|
| 5040 |
Record type (U32) Range capability: No; Release 4.5
Passing this criteria returns the files (MPE filename or HFS pathname) and
unique file identifiers (UFID or path_identifier) of all files whose
record type meets the specified criteria.
The following are the record types:
0 - fixed
1 - variable
2 - undefined
3 - cm_spool
4 - account directory node
5 - user directory node
6 - group directory node
7 - fileset directory node
8 - temporary directory
9 - byte stream
10 - hierarchical directory
|
| 5049 |
Recursion level (I32) Range capability: No; Release 4.5
Passing this criteria specifies the number of directory levels you wish to
traverse in the hierarchical directory. Specify the value 0 to list only
those files in the current level.
The default is infinite traversal; that is, traverse all directories and
sub-directories. This item is ignored if using item 5001.
|
| 5050 |
Ignore non-fatal errors? (B) Range capability: No; Release 5.0
Specifies whether or not the directory traversal should continue even if
an non-fatal error is detected. An example of a non-fatal error is if a
bad UFID is detected of if the user does not have the appropriate security
(no TD) to traverse a directory.
If this item is FALSE and a non-fatal error is detected, the directory
traversal will stop, the error will be returned in the item status array,
and the file where the error was detected will be returned in the search
key. The user can then process the error and continue by calling
AIFSYSWIDEGET again with the search key.
The default is FALSE. |
Accounting Criteria Item Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with accounting criteria used by
AIFSYSWIDEGET.
Table 3-41 AIFSYSWIDEGET Accounting Criteria Item Descriptions
| Item Number> |
Item Name (Data Type) Range capability; Release First
Available Description |
| 6001 |
User name (CA16) Range capability: No; Release 3.0
Passing this criteria returns the directory names whose user names equal
the specified criteria value. Since the same user name may be used in
multiple accounts, criteria item 6201 must be specified. The format is a
16-byte character array containing the identifier of the user name
(left-justified and padded with blanks). Use of @'s for wild carding is
permitted. |
| 6003 |
Capabilities (I32) Range capability: No; Release 3.0
Passing this criteria returns the directory names that have the specified
user capabilities. Item 6001 must also be specified. For example, if bit
(0:1) is set to 1, all directory names (with user names indicated by
criteria 6001) that have SM capability are returned.
| Bit (0:1) | SM |
| Bit (1:1) | AM |
| Bit (2:1) | AL |
| Bit (3:1) | GL |
| Bit (4:1) | DI |
| Bit (5:1) | OP |
| Bit (6:1) | CV |
| Bit (7:1) | UV |
| Bit (8:1) | LG |
| Bit (9:1) | SP |
| Bit (10:1) | PS |
| Bit (11:1) | NA |
| Bit (12:1) | NM |
| Bit (13:1) | CS |
| Bit (14:1) | ND |
| Bit (15:1) | SF |
| Bits(16:7) | Unused (set to 0) |
| Bit (23:1) | BA |
| Bit (24:1) | IA |
| Bit (25:1) | PM |
| Bits(26:2) | Unused (set to 0) |
| Bit (28:1) | MR |
| Bit (29:1) | Unused (set to 0) |
| Bit (30:1) | DS |
| Bit (31:1) | PH |
|
| 6008 |
Local attributes (I32) Range capability: No; Release 3.0
Passing this criteria returns the directory names whose group
user-definable attributes equal the specified criteria value. Criteria
items 6001 and 6201 must also be specified. |
| 6101 |
Group name (CA16) Range capability: No; Release 3.0
Passing this criteria returns the directory names whose group names equal
the specified criteria value. Since the same group name may be used in
multiple accounts, criteria item 6201 must be specified. The format is a
16-byte character array containing the identifier of the group name
(left-justified and padded with blanks). Use of @'s for wild carding is
permitted. |
| 6103 |
Group capabilities (I32) Range capability: No; Release 3.0
Passing this criteria returns the directory names that have the specified
group capabilities. Item 6101 must also be specified. For example, if bit
(31:1) is set to 1, all directory names (with group names indicated by
criteria 6101) that have PH resource capability are returned.
| Bits(0:23) | Unused (set to 0) |
| Bit (23:1) | BA |
| Bit (24:1) | IA |
| Bit (25:1) | PM |
| Bits(26:2) | Unused (set to 0) |
| Bit (28:1) | MR |
| Bit (29:1) | Unused (set to 0) |
| Bit (30:1) | DS |
| Bit (31:1) | PH |
|
| 6201 |
Account name (CA16) Range capability: No; Release 3.0
Passing this criteria returns the directory names whose account names
equal the specified criteria value. The format is a 16-byte character
array containing the identifier of the account name (left-justified and
padded with blanks). Use of @'s for wild carding is permitted. |
| 6203 |
Account capabilities (I32) Range capability: No; Release 3.0
Passing this criteria returns the directory names that have the specified
account capabilities. Item 6201 must also be specified. For example, if
bit (0:1) is set to 1, all directory names (with account names indicated
by criteria 6201) that have SM capability are returned.
| Bit (0:1) | SM |
| Bit (1:1) | AM |
| Bit (2:1) | AL |
| Bit (3:1) | GL |
| Bit (4:1) | DI |
| Bit (5:1) | OP |
| Bit (6:1) | CV |
| Bit (7:1) | UV |
| Bit (8:1) | LG |
| Bit (9:1) | SP |
| Bit (10:1) | PS |
| Bit (11:1) | NA |
| Bit (12:1) | NM |
| Bit (13:1) | CS |
| Bit (14:1) | ND |
| Bit (15:1) | SF |
| Bits(16:7) | Unused (set to 0) |
| Bit (23:1) | BA |
| Bit (24:1) | IA |
| Bit (25:1) | PM |
| Bits(26:2) | Unused (set to 0) |
| Bit (28:1) | MR |
| Bit (29:1) | Unused (set to 0) |
| Bit (30:1) | DS |
| Bit (31:1) | PH |
|
| 6214 |
Local attributes (I32) Range capability: No; Release 3.0
Passing this criteria returns the directory names whose account
user-definable attributes equal the specified criteria value. Criteria
item 6201 must also be specified. |
Spool File Criteria Item Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with spool file criteria used by
AIFSYSWIDEGET.
Table 3-42 AIFSYSWIDEGET Spool File Criteria Item Descriptions
| Item Number |
Item Name (Data Type) Range capability; Release First
Available Description |
| 8501 |
File state (I32) Range capability: No; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose states equal the specified criteria value.
Values and their meanings are as follows:
| 0 | Open state (job/data input spool file being accessed) |
| 1 | Active state (job/data input spool file being created) |
| 2 | Create state (output spool file being created) |
| 3 | Defer state (defer option specified for output spool file) |
| 4 | Ready state (spool file ready to be input or output) |
| 5 | Transfer state (output spool file being transferred
to remote node) |
| 6 | Print state (output spool file being printed on a device) |
| 7 | Problem state (abnormality preventing output spool
file from printing) |
| 8 | Del_pending state (output spool file to be deleted
after closing) |
| 9 | Spsave state (output spool file copies printed,
SPSAVE option specified) |
| 10 | (Reserved) |
|
| 8502 |
Priority (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose output priorities equal that of the specified
criteria value(s).
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 8504 |
Disposition (I32) Range capability: No; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of either of the following:
- Spool files that are to be save after they are printed
- Spool files that are to be purged after they are printed
Values and their meanings are as follows:
| 1 | Save after printing |
| 2 | Purge after printing |
|
| 8509 |
STDLIST of aborted job (I32) Range capability: No; Release 3.0
Passing this criteria returns spool file address and/or spool file number
of either of the following:
- Spool files that are the $STDLIST of an aborted job
- Spool files that are not the $STDLIST of an aborted job
Values and their meanings are as follows:
| 0 | Not $STDLIST of an aborted job |
| 1 | $STDLIST of an aborted job |
|
| 8511 |
Copies (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose total number of copies to be printed equals
the specified criteria value(s).
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 8512 |
Ready date (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose created dates equal the specified criteria
value(s). The format in the 32-bit integer is the same as that returned by
the CALENDAR intrinsic. The format of the data passed is as
follows:
| Bits (0:16) | Unused (set to 0) |
| Bits (16:7) | The year of the century |
| Bits (23:9) | The day of the year |
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 8514 |
Number of pages (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose number of pages equal the specified criteria
value(s).
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 8516 |
User name and account name of creator (CA32) Range capability: No;
Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose creator user and account names equal the
specified criteria value. The first 16 bytes hold the user name, and the
second 16 bytes hold the account name. The names should be left-justified
and padded with blanks. Only the first 8 bytes of each field is
used. |
| 8517 |
Job/session # (REC) Range capability: No; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose creator job/session numbers equal the
specified criteria value.
The format of the data passed is as follows:
| Bits (0:2) | Job or session (see below) |
| Bits (2:30) | The job/session number |
The values of bits (0:2) and their meanings are as follows:
| 0 | Session not current to the system |
| 1 | Session current to the system |
| 2 | Job current to the system |
| 3 | Job not current to the system |
Record type: Bit32 (Refer to appendix B.) |
| 8518 |
Job name (CA16) Range capability: No; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose creator job names equal that of the specified
criteria value. |
| 8519 |
File designator (CA16) Range capability: No; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose formal file designators equal the specified
criteria value. |
| 8520 |
Target device (REC) Range capability: No; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files whose destination logical device number (LDEV),
device name, and device class equal the specified criteria value.
Record type: device_name_type (Refer to appendix B.) |
| 8525 |
Forms ID (CA16) Range capability: No; Release 3.0
Passing this criteria returns the output spool file address and/or spool
file number of spool files whose forms IDs equal the specified criteria
value. |
| 8528 |
Number of records (I32) Range capability: Yes; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of spool files with the number of records equal to the specified
criteria value(s).
A range of values can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by
passing the lower and upper limits in the corresponding consecutive
elements of item_array. The first value must be the lower
limit (>=) and the second value, the upper limit (<=). |
| 8600 |
Input/output (I32) Range capability: No; Release 3.0
Passing this criteria returns the spool file address and/or spool file
number of either input spool files or output spool files. Values and their
meanings are as follows:
| 1 | Return input spool files |
| 2 | Return output spool files |
|
Device Criteria Item Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with device criteria used by
AIFSYSWIDEGET.
Table 3-43 AIFSYSWIDEGET Device Criteria Item Descriptions
| Item Number |
Item Name (Data Type) Range Capability; Release First
Available Description |
| 13001 |
Logical Device Number (I32) Range Capability: Yes; Release 4.0
This is the LDEV number for the device.
Specifying a LDEV number will return the LDEV number and the device key if
it is configured.
Specifying a range of LDEV numbers will return a list of configured LDEV's
and the device keys within that range.
A range of LDEV numbers can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by passing the lower
and upper limits in the corresponding consecutive elements of item_array.
The first value will be the lower limit ( >= ) and the second value,
the upper limit ( <= ). |
| 13002 |
User-Defined Device Class Name (C16) Range Capability: No;
Release 4.0
This is the name of the device class assigned by the user using the I/O
configurator command ACLASS in SYSGEN. The name is in upper-case,
left-justified and padded with blanks to the right. Use of @'s for wild
carding is permitted (for example, '@TAPE@').
Specifying a device class will return the configured LDEV numbers and the
device keys belonging to that device class. |
Device Class Criteria Item Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with device class criteria used by
AIFSYSWIDEGET.
Table 3-44 AIFSYSWIDEGET Device Criteria Item Descriptions
| Item Number |
Item Name (Data Type) Range Capability; Release First
Available Description |
| 13501 |
Logical Device Number (I32) Range Capability: Yes; Release 4.0
This is the LDEV number for the device.
Specifying a LDEV number will return the user-defined device classes of
which the LDEV belongs and the corresponding device class keys.
Specifying a range of LDEV numbers will return a list of user-defined
device classes and device keys for each LDEV within that range.
A range of LDEV numbers can be requested by passing the same criteria item
number in consecutive elements of itemnum_array and by passing the lower
and upper limits in the corresponding consecutive elements of item_array.
The first value will be the lower limit ( >= ) and the second value,
the upper limit ( <= ). |
| 13502 |
User-Defined Device Class Name (C16) Range Capability: No;
Release 4.0
This is the name of the device class assigned by the user using the I/O
configurator command ACLASS in SYSGEN. The name is in upper-case,
left-justified and padded with blanks to the right. Use of @'s for wild
carding is permitted (for example, '@TAPE@').
Specifying a device class or a wildcarded device class will return the
device class(es) and the device class key(s). |
Console Reply Information Criteria Item
Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with console reply criteria used by
AIFSYSWIDEGET.
Table 3-45 AIFSYSWIDEGET Console Reply Information Criteria Item Descriptions
| Item Number |
Item Name (Data Type) Range Capability; Release First
Available Description |
| 14002 |
Process Type (I32) Range capability:No; Release 4.0
Passing this criteria returns all reply request ids associated with either
of the following:
- System Processes
- User Processes
Values and their meanings are as follows:
| 0 | System Process |
| 1 | User Process |
|
| 14003 |
Creation Time (I32) Range capability:Yes; Release 4.0
Passing this criteria returns all reply request ids for the creation time
passed in. The format that can be passed is the same as returned by the
CLOCK Intrinsic.
| Bits (0:8) | The hour of the day |
| Bits (8:8) | The minute of the hour |
| Bits (16:8) | The seconds |
| Bits (24:8) | The tenths of seconds |
|
| 14004 |
Job/Session Number (REC) Release 4.0
Passing this criteria returns all reply request ids associated with the
job or session number that is passed in. This is only valid for user
processes.
The format of Job or Session Number is:
| Bits (0:2) | Job or session (1=session, 2=job) |
| Bits (2:30) | Job or session Number |
|
| 14005 |
Pin of the request (I32) Release 4.0
Passing this criteria returns all reply request ids associated with the
pin that is passed in. |
Workgroup Criteria Item Descriptions
The following table provides detailed descriptions of the item numbers and
corresponding items associated with the new criteria, workgroup
used by AIFSYSWIDEGET. The return value for the workgroup area is
workgroup name(s).
Table 3-46 AIFSYSWIDEGET Workgroup Criteria Item Descriptions
| Item Number |
Item Name, Data Type, and Description |
| 19001 |
Workgroup name (CA256) Wildcarding capability: No
Passing this criteria returns the name of the workgroups that match the
passed workgroup name. The name must be left-justified and terminated by
a NULL character (ASCII 0). Use the @ symbol to represent all the
workgroups. |
| 19003 |
Logon/User specification (CA256) Wildcarding capability: No
Passing this criteria returns all the workgroups that have the specified
jobname, username.acctname as one of its membership criteria. The logon
must be left-justified and terminated by a NULL character (ASCII 0). Use
the @ symbol to represent all logons on the system. Only one logon/user
can be specified. For example
narinder,mgr.aiftest |
| 19004 |
Program/File name (REC) Wildcarding capability: No
Passing this criteria returns all the workgroups that have the specified
file as one of its membership criteria. The name must be left-justified.
The length of the item passed must be specified in the length field of the
pathname_type record. Use the @ symbol to represent all files on the
system. Only one program/file name can be specified. For example,
Editor.pub.sys
Record Type: pathname_type. The maximum size of n which is
user-defined is 512. |
| 19005 |
Queue (CA20);
Passing this criteria returns all the workgroups that have the specified
queue as one of its membership criteria. The queue must be left-justified
and terminated by a NULL character (ASCII 0). Use the @ symbol to
represent all queues of the set. Only one queue can be specified. For
example,
|
| 19006 |
Queue (I32) Range capability: Yes
Passing this criteria returns all the workgroups that have the specified
queue as one of its membership criteria. Values and their meanings are as
follows:
| 0 | AS Queue |
| 1 | BS Queue |
| 2 | CS Queue |
| 3 | DS Queue |
| 4 | ES Queue |
A range of values can be requested by passing the same criteria number in
consecutive elements of itemnum_array and by passing the lower and upper
limits in the corresponding consecutive elements of item_array. The first
value must be the lower limit (>=) and the second value, the upper
limit (<=).
The queue is represented as a character array in AIFWGADD and AIFWGGET/PUT.
In order to have ranging capabilities, queue is represented by integers
in AIFSYSWIDEGET. See item 19005 of AIFWGADD and AIFWGGET/PUT. |
| 19007 |
Base Priority (I32) Range capability: Yes
Passing this criteria returns all the workgroups that have the specified
base priority value(s).
MPE/iX priorities are values in the range 0..32767. An MPE/iX priority is
inverted with respect to an MPE V/E priority in that in MPE/iX higher
priority values indicate higher priority. The conversion to MPE V/E
priority can be accomplished as follows:
(all values are decimal)
MPEVpri = (32767 - MPEiXpri) div 128
A range of values can be requested by passing the same criteria number in
consecutive elements of itemnum_array and by passing the lower and upper
limits in the corresponding consecutive elements of item_array. The first
value must be the lower limit (>=) and the second value, the upper
limit (<=). |
| 19008 |
Limit Priority (I32) Range capability: Yes
Passing this criteria returns all the workgroups that have the specified
limit priority value(s).
MPE/iX priorities are values in the range 0..32767. An MPE/iX priority is
inverted with respect to an MPE V/E priority in that in MPE/iX higher
priority values indicate higher priority. The conversion to MPE V/E
priority can be accomplished as follows:
(all values are decimal)
MPEVpri = (32767 - MPEiXpri) div 128
A range of values can be requested by passing the same criteria number in
consecutive elements of itemnum_array and by passing the lower and upper
limits in the corresponding consecutive elements of item_array. The first
value must be the lower limit (>=) and the second value, the upper
limit (<=). |
| 19009 |
Minimum Quantum (I32) Range capability: Yes
Passing this criteria returns all the workgroups that have the specified
minimum quantum value(s).
Values for minimum quantum range from 0 to 32767 milliseconds.
A range of values can be requested by passing the same criteria number in
consecutive elements of itemnum_array and by passing the lower and upper
limits in the corresponding consecutive elements of item_array. The first
value must be the lower limit (>=) and the second value, the upper
limit (<=). |
| 19010 |
Maximum Quantum (I32) Range capability: Yes
Passing this criteria returns all the workgroups that have the specified
maximum quantum value(s).
Values for maximum quantum range from 0 to 32767 milliseconds.
A range of values can be requested by passing the same criteria number in
consecutive elements of itemnum_array and by passing the lower and upper
limits in the corresponding consecutive elements of item_array. The first
value must be the lower limit (>=) and the second value, the upper
limit (<=). |
| 19011 |
Timeslice (I32) Range capability: Yes
Passing this criteria returns all the workgroups that have the specified
timeslice value(s).
Values for timeslice range from 100 to 32700.
A range of values can be requested by passing the same criteria number in
consecutive elements of itemnum_array and by passing the lower and upper
limits in the corresponding consecutive elements of item_array. The first
value must be the lower limit (>=) and the second value, the upper
limit (<=). |
| 19012 |
Boost Property (I32) Range capability: No
Passing this criteria returns all the workgroups that have the specified
boost property value. Values and their meanings are as follows:
Since Boost Property has only two values, range capability is not needed.
If boost property is not specified, it is ignored as search
criteria. |
| 19013 |
Minimum CPU Percentage (I32) Range capability: Yes
Passing this criteria returns all the workgroups that have the specified
Minimum CPU Percentage value(s).
The value can range from 0% to 100%.
A range of values can be requested by passing the same criteria number in
consecutive elements of itemnum_array and by passing the lower and upper
limits in the corresponding consecutive elements of item_array. The first
value must be the lower limit (>=) and the second value, the upper
limit (<=). |
| 19014 |
Maximum CPU Percentage (I32) Range capability: Yes
Passing this criteria returns all the workgroups that have the specified
Maximum CPU Percentage value(s).
The value can range from 0% to 100%.
A range of values can be requested by passing the same criteria number in
consecutive elements of itemnum_array and by passing the lower and upper
limits in the corresponding consecutive elements of item_array. The first
value must be the lower limit (>=) and the second value, the upper
limit (<=). |
|
