INGDATA

Purpose

The INGDATA command returns detailed information that the automation manager maintains for the specified resources. The data is returned as a multiline message, one line for each resource.

The format is as follows:

Byte	Length	Description
1	11	Name of resource
14	3	Resource type, for example, APG or APL
19	8	Name of system hosting resource
29	11	Observed status
41	12	Desired status
54	10	Automation status
65	4	Automation flag
70	4	Hold flag
75	48	Description
125	10	Start type
137	8	Stop type
147	8	Service period name
157	8	Trigger name
167	12	Compound status
181	10	Startability status
193	8	Resource nature (group type)
203	10	Category
213	10	Subcategory
224	12	Health status
237	8	Jobname
246	40	Inform list
287	3	Runmode qualification
291	8	Desired default status
300	20	Pacing gate
321	13	Pacing status
335	3	Suspend flag value
339	1	APG model
341	3	Dynamic

Syntax

filter criteria

Parameters

NETVASIS

Prefix the INGDATA command with NETVASIS if you want to pass the description text in lower or mixed case.

resource

Specifies the name of the resource (or resources) to be displayed. The format is name/type<[</system>]>. It can be a list of names.

The resource names must be separated by a blank. Asterisks (*) and a percentage sign (%) can be used as wildcard characters.

WAIT

Specifies the number of seconds to wait before reporting that a timeout occurred if the automation manager does not provide the requested data. The maximum time interval is 999 seconds.

If omitted, the time interval is 30 seconds.

filter criteria

The filter criteria to be applied prior to displaying the data. The following values can occur:

OBSERVED

Specifies the observed statuses to be displayed. The statuses must be separated by a blank. It can be abbreviated, for example, to AV for available.

If '^' or '\' is used, all statuses except the ones you specify are displayed. Here is a list of possible Observed Status values and their shortest possible abbreviations: AVAILABLE (A), UNKNOWN (U), SYSGONE (SY), SOFTDOWN (SO), HARDDOWN (H), STARTING (STAR), DEGRADED (D), STOPPING (STO), PROBLEM (P), WASAVAILABLE (W), and STANDBY (STAN).

DESIRED

Specifies the desired statuses to be displayed. The statuses must be separated by a blank. It can be abbreviated, for example, to AV for available.

If '^' or '\' is used, all statuses except the ones you specify are displayed. Here is a list of possible Desired Status values and their shortest possible abbreviations: AVAILABLE (A), UNAVAILABLE (U), and UNKNOWN (UNK).

AUTOSTAT

Specifies the automation status to be displayed. The statuses must be separated by a blank. It can be abbreviated, for example, to ID for idle.

If '^' or '\' is used, all statuses except the ones you specify are displayed. Here is a list of possible Autostat Status values and their shortest possible abbreviations: UNKNOWN (U), IDLE (ID), ORDERED (O), BUSY (B), DENIED (D), PROBLEM (P), and INTERNAL (IN).

AUTOFLAG

Specifies the automation flag to be displayed. It can be either YES or NO and can be abbreviated.

COMPOUND

Specifies the compound status. The statuses must be separated by a blank. It can be abbreviated, for example, to SA for satisfactory.

If '^' or '\' is used, all statuses except the ones you specify are displayed. Here is a list of possible Compound Status values and their shortest possible abbreviations: PROBLEM (P), DENIED (DEN), INHIBITED (INH), AWAITING (AW), INAUTO (INA), DEGRADED (DEG), and SATISFACTORY (S).

CATEGORY

Specifies the IBM-defined or user-defined category that the resource belongs to. More than one value can be specified.

SUBCAT

Specifies the IBM-defined or user-defined subcategory of the resource. More than one value can be specified. For compatibility reasons keyword SUBTYPE is still accepted.

DESCR

Specifies the text string that is used as a filter. The text can contain wildcards. An asterisk (*) matches a string of arbitrary length and a percentage sign (%) matches a single character. The DESCR parameter is case-sensitive. The text string must be enclosed in single or double quotation marks or parentheses() to maintain the case-sensitivity of the entry.

GROUPTYPE

Specifies the type (nature) of the resource group. More than one value can be specified.

HEALTH

Specifies the desired health statuses to be displayed. The statuses must be separated by a blank. It can be abbreviated, for example, to NO for normal. You can also specify an asterisk (*) to reset the current filter setting, for example, INGFILT HEALTH=*.

If '^' or '\' is used, all statuses except the ones you specify are displayed. Here is a list of possible Health Status values and their shortest possible abbreviations: SYSGONE (S), UNKNOWN (U), NORMAL (N), WARNING (W), MINOR (M), CRITICAL (C), and FATAL (F).

JOBNAME

The jobname that is assigned to the resource. More than one jobname can be specified. Wildcards are supported.

RUNTOKEN

The runtoken that is assigned to the resource. More than one runtoken can be specified. Wildcards are supported.

PGNAME

The pacing gate that is assigned to the resource. More than one pacing gate can be specified. Wildcards are supported. You can also specify an asterisk (*) to reset the current filter setting.

APGMODEL

Specifies the model of an application group (APG) of nature MOVE or SERVER. Valid values are 1, 2, or an asterisk (*).

1: Only model 1 APGs are listed.
2: Only model 2 APGs are listed.
*: Both APG models are listed.

DYNRES

Specifies whether a resource was created dynamically. Valid values are YES, NO, or an asterisk (*).

YES: Only resources that were created dynamically are listed.
NO: Only resources that were not created dynamically are listed.
*: Both kinds of resources are listed.

TARGET

For information on the TARGET parameter, refer to IBM Z System Automation Operator's Commands.

Return Codes

0: Okay.
1: An error occurred.
2: SA z/OS has not fully initialized.

Restrictions and Limitations

SA z/OS must be fully initialized.

Usage

The INGDATA command should be used in a NetView PIPE statement.

There is an API in INGGROUP ACTION=DATA that returns detailed information about the specified resource(s). See INGGROUP in IBM Z System Automation Operator's Commands.