Host Environment Commands › ADDRESS SOF—Manage Devices › QUERY SOF Request Types › QUERY CHPIDS—Query Global Channel Port ID

QUERY CHPIDS—Query Global Channel Port ID

The QUERY CHPIDS command obtains global channel port ID (ChpID) information for the following:

• A specific ChpID by the device ID
• A range of ChpID based on the relative position number assigned by SOF for all known ChpID

The range form of this command can limit the amount of output per command. To continue the output, start at the next sequential relative position number. If CHPID is omitted and STARTPOS is not specified, then STARTPOS defaults to (0,65535).

This command has the following format:

QUERY CHPIDS  [CHPID(devid) | STARTPOS(relative position number,
   count of ChpIDs to return) ]

Created stem variables

The output stem variable records contain the following word delimited fields for each GLOBAL ChpID information record returned by the SOF server.

• Global relative position number - Contains integer
• Number of connected LPARS - Contains integer
• ChpID channel path number - Contains two printable hex digits
• ChpID identifier - Contains the ChpID DevID string
• Switch port address - Contains two printable hex digits 00-FF
• Switch identifier - Contains the switch DevID string