Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-INSTALLATION-ITEMS Show installation items

&pagelevel(4)&pagelevel

Privileges:          STD-PROCESSING, SUBSYSTEM-MANAGEMENT

Function

The SHOW-INSTALLATION-ITEMS statement enables you to show information about the installation items in the open SCI (see "Installation item (II) ").

If you are a nonprivileged user, this statement only shows the path names for which DMS access is possible.

The statement supports structured output in S variables (see "Output in S variables" "SHOW-INSTALLATION-ITEMS Show installation items "“).

Format

SHOW-INSTALLATION-ITEMS

ITEM-NAME = *BY-INSTALLATION-PATH(...) / *FROM-FORMATTED-FILE(...) /






list-poss(30): <filename 1..30 without-cat-user-gen-vers>(...)


*BY-INSTALLATION-PATH(...)



|

PATH-NAME = <filename 1..54 without-gen-vers>


*FROM-FORMATTED-FILE(...)



|

FILE-NAME = <filename 1..54 without-gen-vers>


<filename 1..30 without-cat-user-gen-vers>(...)



|

VERSION = *ALL / *HIGHEST-EXISTING / <c-string 1..5>



|

,UNIT-NAME = *ALL / list-poss(5): <text 1..30 without-sep>(...)



|


<text 1..30 without-sep>(...)



|



|

VERSION = *ALL / *HIGHEST-EXISTING / <product-version without-man-corr>



|



|

,CORRECTION-STATE = *ALL / *HIGHEST-EXISTING / *LOWEST-EXISTING



|



|


list-poss(3): <alphanum-name 3..3>

,INFORMATION = *PARAMETERS(...)


*PARAMETERS(...)



|

REPORT-LEVEL = *MINIMUM / *ALL-ATTRIBUTES

,OUTPUT = *SYSOUT / *SYSLST(...) / *INPUT-FORMATTED-FILE / <filename 1..54 without-gen-vers>(...) / *NONE

*SYSLST(...)


|SYSLST-NUMBER = *STD / <integer 1..99>

<filename 1..54 without-gen-vers>(...)


|WRITE-MODE = *REPLACE / *EXTEND
,STRUCTURE-OUTPUT = *NONE / *SYSINF / <composed-name 1..255>(...)

<composed-name 1..255>(...)


|WRITE-MODE = *REPLACE / *EXTEND


Operands

ITEM-NAME =

Select the installation item.

ITEM-NAME = *BY-INSTALLATION-PATH(...)

The item is already installed and will be selected by its path name.

PATH-NAME = <filename 1..54 without-gen-vers>

Path name of the installation item.

ITEM-NAME = *FROM-FORMATTED-FILE(...)

The installation items will be taken from the formatted file.

FILE-NAME = <filename 1..54 without-gen-vers>

Name of the formatted file.

ITEM-NAME = list-poss(30): <filename 1..30 without-cat-user-gen-vers>(...)

Name of the installation item, see "Installation item (II) ".

VERSION =

Version of the installation item.

VERSION = *ALL

Select all versions of the installation item.

VERSION = *HIGHEST-EXISTING

Select the highest version of the installation item.

VERSION = <c-string 1..5>

Explicit specification of the version of the installation item.

UNIT-NAME =

Name of the installation unit searched for the installation item.

UNIT-NAME = *ALL

Search for the installation item in all registered installation units.

UNIT-NAME = list-poss(5): <text 1..30 without-sep>(...)

Specifies the installation unit searched for the installation item, see "Installation item (II) ".

VERSION =

Version of the installation unit.

VERSION = *ALL

Search all versions of the installation unit.

VERSION = *HIGHEST-EXISTING

Search the highest version of the installation unit.

VERSION = <product-version without-man-corr>

Version designation without release and correction states.

CORRECTION-STATE =

Correction state of the specified installation unit.

CORRECTION-STATE = *ALL

Search all correction states of the installation unit.

CORRECTION-STATE = *HIGHEST-EXISTING

Search the highest correction state of the installation unit.

CORRECTION-STATE = *LOWEST-EXISTING

Search the lowest correction state of the installation unit.

CORRECTION-STATE = list-poss(3): <alphanum-name 3..3>

Explicit specification of the correction state of the installation unit.

Format: <aso>.

INFORMATION = *PARAMETERS(...)

The scope of information to be shown.

REPORT-LEVEL =

The reporting level for installation item attributes.

REPORT-LEVEL = *MINIMUM

Show the names of the installation items.

REPORT-LEVEL = *ALL-ATTRIBUTES

Show the names and attributes of the installation items.

OUTPUT =

The target for output.

OUTPUT = *SYSOUT

Output the information to SYSOUT.

OUTPUT = *INPUT-FORMATTED-FILE

Output the information to the formatted file specified in the operand

ITEM-NAME=*FROM-FORMATTED-FILE(FILE-NAME=).

OUTPUT = *NONE

No output is generated except structured output when requested.

OUTPUT = *SYSLST(...)

Output the information to SYSLST.

SYSLST-NUMBER =

SYSLST number.

SYSLST-NUMBER = *STD

Output the information to standard SYSLST.

SYSLST-NUMBER = <integer 1..99>

Specifies the SYSLST number.

OUTPUT = <filename 1..54 without-gen-vers>(...)

Output the information to the formatted file. Use the SHOW-FORMATTED-FILE statement to output the collected information in a formatted file.

WRITE-MODE =

Write or extend the file.

WRITE-MODE = *REPLACE

Generate the formatted file or overwrite an existing file.

WRITE-MODE = *EXTEND

Generate the formatted file or extend an existing file.

STRUCTURE-OUTPUT =

Target of structured output when requested.

STRUCTURE-OUTPUT = *NONE

No structured output is requested.

STRUCTURE-OUTPUT = *SYSINF

Specification is only possible if the chargeable subsystem SDF-P is available.

The SYSINF stream is to be used for structured output.

STRUCTURE-OUTPUT = <composed-name 1..255>(...)

Specification is only possible if the chargeable subsystem SDF-P is available.

Name of the S-variable (of the “list” type) to be used for the structured output.

WRITE-MODE = *REPLACE

The S-variable is created or overwritten if already existing.

WRITE-MODE = *EXTEND

S-variable is completed with the new information.

Notes

  1. Input

    • If ITEM-NAME=*FROM-FORMATTED-FILE is specified, the ID of the objects to be shown is taken from the formatted file records that contain an identifier for the desired object type.

    • For the sake of consistency, we recommend that you only specify a SHOW statement for a formatted file if it was generated with the same SCI status. However, if the information in the SCI has changed since the formatted file was created, the information that is output is not longer current.

  2. Output

    • If the user does not have the SUBSYSTEM-MANAGEMENT privilege, the path name of the installation items is only output when the user has DMS access to it (e.g. SHOW-FILE possible). Otherwise, an asterisk (*) is output.

    • If the output is directed to SYSOUT or SYSLST, the information is edited so as to be legible.

    • If the information is directed to a formatted file, the output is compressed and is not legible for the user.

  3. In the following cases execution of the statement is continued with a warning:

    • An object, for which information is to be supplied, does not exist in the SCI.

    • If, when displaying an installation item, the file name returned by the path name manager is not the same as that specified during registration, both file names are displayed.

  4. In the following cases, a warning is issued and execution of the statement resumes:

    • The explicitly specified alphanumeric correction state is not a letter followed by two numbers.

    • ITEM-NAME=*FROM-FORMATTED-FILE was specified, but the corresponding file does not exist or cannot be accessed.

    • OUTPUT=*INPUT-FORMATTED-FILE was specified, but the ITEM-NAME parameter is not *FROM-FORMATTED-FILE.

    • There are duplicate units in the input list, i.e. units with the same values or key words for one of the identification parameters.

Output in S variables

Output information

Name of the S variable

T

Contents

current container access right

(ACCESS)

var(*LIST).II-CONTAINER(*LIST).

CURRENT-ACCESS

S

Read/Write

current container access control

list

var(*LIST).II-CONTAINER(*LIST).

CURRENT-ACL

S

Yes/No

current container backup class

var(*LIST).II-CONTAINER(*LIST).

CURRENT-BACK-CLASS

S

<c-string 1..1>

current container basic access

control list

var(*LIST).II-CONTAINER(*LIST).

CURRENT-BASIC-ACL

S

<c-string 1..9>

current container block control

information

var(*LIST).II-CONTAINER(*LIST).

CURRENT-BLK-CONTR

S

None / No / Pamkey /

Data / Data-2K /

Data-4K

current container change date

var(*LIST).II-CONTAINER(*LIST).

CURRENT-CHANGE-DATE

S

yyyy-mm-dd

current container change time

var(*LIST).II-CONTAINER(*LIST).

CURRENT-CHANGE-TIME

S

hh:mm:ss

current container creation date

var(*LIST).II-CONTAINER(*LIST).

CURRENT-CREA-DATE

S

yyyy-mm-dd

current container creation time

var(*LIST).II-CONTAINER(*LIST).

CURRENT-CREA-TIME

S

hh:mm:ss

current container migration identifier

var(*LIST).II-CONTAINER(*LIST).

CURRENT-MIGRATE

S

Allowed / Special /

Inhibit

current container access right

(USER-ACCESS)

var(*LIST).II-CONTAINER(*LIST).

CURRENT-USER-ACC

S

All / Special /

Owner-Only

initial container access right

(ACCESS)

var(*LIST).II-CONTAINER(*LIST).

INIT-ACCESS

S

Read/Write

initial container access control list

var(*LIST).II-CONTAINER(*LIST).INIT-ACL

S

Yes/No

initial container backup class

var(*LIST).II-CONTAINER(*LIST).

INIT-BACK-CLASS

S

<c-string 1..1>

initial container basic access

control list

var(*LIST).II-CONTAINER(*LIST)

.INIT-BASIC-ACL

S

<c-string 1..9>

initial container block control

information

var(*LIST).II-CONTAINER(*LIST).

INIT-BLK-CONTR

S

None / No / Pamkey /

Data / Data-2K /

Data-4K

initial container change date

var(*LIST).II-CONTAINER(*LIST).

INIT-CHANGE-DATE

S

yyyy-mm-dd

initial container change time

var(*LIST).II-CONTAINER(*LIST).

INIT-CHANGE-TIME

S

hh:mm:ss

initial container creation date

var(*LIST).II-CONTAINER(*LIST).

INIT-CREA-DATE

S

yyyy-mm-dd

initial container creation time

var(*LIST).II-CONTAINER(*LIST).

INIT-CREA-TIME

S

hh:mm:ss

initial container migration identifier

var(*LIST).II-CONTAINER(*LIST).

INIT-MIGRATE

S

Allowed / Special /

Inhibit

initial container access right

(USER-ACCESS)

var(*LIST).II-CONTAINER(*LIST).

INIT-USER-ACC

S

All / Special /

Owner-Only

current access right (ACCESS)

var(*LIST).II-CURR-ACCESS

S

Read/Write

current access control list

var(*LIST).II-CURR-ACL

S

Yes/No

current backup class

var(*LIST).II-CURR-BACK-CLASS

S

<c-string 1..1>

current basic access control list

var(*LIST).II-CURR-BASIC-ACL

S

<c-string 1..9>

current block control information

var(*LIST).II-CURR-BLK-CONTR

S

None / No / Pamkey /

Data / Data-2K /

Data-4K

current change date

var(*LIST).II-CURR-CHANGE-DATE

S

yyyy-mm-dd

current change time

var(*LIST).II-CURR-CHANGE-TIME

S

hh:mm:ss

current creation date

var(*LIST).II-CURR-CREA-DATE

S

yyyy-mm-dd

current creation time

var(*LIST).II-CURR-CREA-TIME

S

hh:mm:ss

current migration identifier

var(*LIST).II-CURR-MIGRATE

S

Allowed / Special /

Inhibit

current access right (USER-

ACCESS)

var(*LIST).II-CURR-USER-ACC

S

All / Special /

Owner-Only

initial access right (ACCESS)

var(*LIST).II-INIT-ACCESS

S

Read/Write

initial access control list

var(*LIST).II-INIT-ACL

S

Yes/No

initial backup class

var(*LIST).II-INIT-BACK-CLASS

S

<c-string 1..1>

initial basic access control list

var(*LIST).II-INIT-BASIC-ACL

S

<c-string 1..9>

initial block control information

var(*LIST).II-INIT-BLK-CONTR

S

None / No / Pamkey /

Data / Data-2K /

Data-4K

initial container change date

var(*LIST).II-INIT-CHANGE-DATE

S

yyyy-mm-dd

initial change time

var(*LIST).II-INIT-CHANGE-TIME

S

hh:mm:ss

initial creation date

var(*LIST).II-INIT-CREA-DATE

S

yyyy-mm-dd

initial creation time

var(*LIST).II-INIT-CREA-TIME

S

hh:mm:ss

initial migration identifier

var(*LIST).II-INIT-MIGRATE

S

Allowed / Special /

Inhibit

initial access right (USER-

ACCESS)

var(*LIST).II-INIT-USER-ACC

S

All / Special /

Owner-Only

change date

var(*LIST).II-CHANGE-DATE

S

yyyy-mm-dd

change time

var(*LIST).II-CHANGE-TIME

S

hh:mm:ss

current container path

var(*LIST).II-CONTAINER(*LIST).

CURRENT-PATH

S

<filename 1..54>

current container path status flag

var(*LIST).II-CONTAINER(*LIST).

CURRENT-PATH-PLACED

B

FALSE / TRUE

initial container path name

var(*LIST).II-CONTAINER(*LIST).INIT-PATH

S

<filename 1..54>

initial container path status flag

var(*LIST).II-CONTAINER(*LIST)

.INIT-PATH-PLACED

B

FALSE / TRUE

creation date

var(*LIST).II-CREA-DATE

S

yyyy-mm-dd

creation time

var(*LIST).II-CREA-TIME

S

hh:mm:ss

current path name

var(*LIST).II-CURR-PATH

S

<filename 1..54>

current path status flag

var(*LIST).II-CURR-PATH-PLACED

B

FALSE / TRUE

function level

var(*LIST).II-FU-LEVEL

S

BOTH / TPR / TU

initial path

var(*LIST).II-INIT-PATH

S

<filename 1..54>

initial path status flag

var(*LIST).II-INIT-PATH-PLACED

B

FALSE / TRUE

name of installation unit

var(*LIST).II-IU-NAME

S

<text 1..30>

version of installation unit

var(*LIST).II-IU-VERSION

S

<product-version

7..7>

logical name

var(*LIST).II-LOGICAL-ID

S

<filename 1..30>

name of the installation item

var(*LIST).II-NAME

S

<filename 1..30>

hardware variant

var(*LIST).II-TARGET

S

A/S/R/P/U

item type

var(*LIST).II-TYPE

S

<c-string 1..3>

user ID

var(*LIST).II-USID

S

<name 1..8>

version of the installation item

var(*LIST).II-VERSION

S

<c-string 1..5>

Powered by Atlassian Confluence and Scroll Viewport.