NEWS Device Solicitation Procedures › $NWVPDSO Procedure

$NWVPDSO Procedure

This procedure solicits vital product data from a PU (and its port-attached devices).

$NWVPDSO      NODE=network_name
            [ REPORT={ PU | ALL } ]
            [ RESPONSE={ LOG | USER | BOTH | FILE }
            [YEARFMT={ YY | YYYY }
            [ FILEDD=ddname ]
            [ LINK=link_name |
              SSCP=SSCP_name ]

Operands: $NWVPDSO Procedure

NODE

Specifies the network name of the device to which the request is sent.

REPORT={ PU | ALL }

Specifies whether the data is sent for the PU only or the PU and its port-attached devices (if the PU supports such a request).

PU

Specifies the product data is from the PU only.

ALL

Specifies the product data is from the PU and all port-attached devices.

RESPONSE={ LOG | USER | BOTH | FILE }

Indicates where the responses are delivered:

LOG

Indicates response data is sent to CNMPROC.

USER

Indicates response data is returned to the requesting procedure.

BOTH

Indicates response data is delivered to CNMPROC and the requesting procedure.

FILE

Indicates response data is written to the file specified by the FILEDD=ddname operand.

Example 1

$NWVPDSO NODE=PU374501 REPORT=PU LINK=TEST01

This example requests vital product data for the PU to be sent to the PU PU374501 across the link TEST01 and the results to be returned to CNMPROC.

Example 2

$NWVPDSO NODE=TSTC02 RESPONSE=FILE FILEDD=VPDFILE

This example requests vital product data to be sent to device TSTC02 and all its port-attached devices with the result of the solicitation (if successful) written to the file allocated by the DD name VPDFILE.

File Format for the Vital Product Data File

Key

One of the following:

NODENAME (8 chars)

UNIQUE PORT NUMBER (3 digits)

YY/MM/DD (8 chars) (by default)

YYYYMMDD (if YEARFMT=YYYY has been specified)

HH:MM:SS (8 chars)

Fields

Note: All fields will probably not be used for all records contained in this file.

Device hierarchy in the standard NEWSFILE record format

Hardware Common Name

Hardware Machine Type (and model (MODEL xxx))

Hardware Serial Number

Hardware Repair ID

Emulated Hardware Machine Type (and model (MODEL xxx))

Microcode EC Level

Software Product Common Name

Software Product Common Level (Vx.x.x)

Software Product Program Number

Software Serviceable Component

Software Serviceable Component Release Level (xxx)

Software Customization

Software Customization Date and Time (YY/MM/DDHH:MM)

Primary LU Address

Hardware Group

Port Type

Port Number

Vendor ID

Physical Location

LAN Universal Address

Additional Attribute Label

Additional Attribute Data