Previous Topic: PPRCCMD DELETE VOLUME—Delete selected PPRC volume pairNext Topic: PPRCCMD Request Examples

Host Environment Commands › ADDRESS SOF—Manage Devices › ADDRESS SOF Examples

ADDRESS SOF Examples

The examples presented here demonstrate various uses of the ADDRESS SOF command. Actual commands will start with “ADDRESS SOF”. To simplify the appearance in these examples, “ADDRESS SOF” is omitted.

Example 1: Find the Servers

This command finds all SOF servers with the CCI application name starting with 'ABCDE'.

“FIND SOF SERVER(*,ABCDE*)”

Note: This is a command to the CCI API, and you can use wildcards to specify the SERVER.

Example 2: Obtain List of Managed Systems

This command obtains a list of all SOF managed systems that are connected to the specified SOF server and have the same CCI application name. 

“QUERY SYSTEMS SYSNAME(*) SERVER(A11SENF,OPSofServer)”

Example 3: Send an Operator Command to the SOF Server

This command sends an operator command to the SOF server specified by the SERVER keyword.

“COMMAND 'Display Defaults' SERVER(A31SENF,OPSofServer)"

Example 4: Obtain Port Information

This command obtains port information on switch ports 0-F, associated with the switch identified by the SWITCH keyword.

“QUERY PORTS PORTADDR(0,f)”, “SWITCH(006064001MCD010000831206250006)”,
“SERVER(A11SENF,OPSofServer)'”
Example 5: Obtain Configuration Information

This command obtains configuration file information for the file associated with the switch identified by the SWITCH keyword.

“QUERY FILES SERVER(A11SENF,OPSofServer)”,
“SWITCH(009032005IBM020000000412030000)”

Example 6: Use of the FILTERBY Keyword

This example issues the FILTERBY keyword on the QUERY command against a control unit. It will retrieve information only for attached devices made by manufacturer XYZ with tags starting with 4A.

ADDRESS SOF 'QUERY DEVICES',
'CONTROLUNIT(002105302MFG060000000806960326)',
'FILTERBY(*,*,XYZ,*,*,4A**)'

Both the control unit and every attached device have a unique device ID (DevID) consisting of the following components:

Note: In this example, we entered the entire control unit DevID for proper CU identification, separated the DevID for device selection into individual components to comply with FILTERBY syntax, specified the full manufacturer 3-character ID, and partially wildcarded the Tag.