Host Environment Commands › ADDRESS SOF—Manage Devices › Non-QUERY SOF Request Types › FIND SOF—Find Active SOF Servers

FIND SOF—Find Active SOF Servers

The FIND SOF command finds active SOF servers.

This command has the following command format:

FIND SOF [OPTION(CCIPLEX)] SERVER(CCIsysname,CCIapplname)

FIND

Allows wildcarding to the SERVER definition. The FIND request is directed to the CCI API, not the SOF server.

OPTION(CCIPLEX)

(Optional keyword) Indicates that the CCI system name in the SERVER keyword is actually a CCI sysplex name. Only servers belonging to this CCI sysplex will be eligible for selection.

The optional SERVER keyword specifies a specific or generic CCI system name and an SOF server CCI application name. The full or generic application name that is specified should match the cciapplname parameter of an SOF server.

If the SERVER keyword or any arguments are omitted, the default values of ccisysname='*' and cciapplname='OPS*' are used.

Created stem variables:

Important! Due to concurrent parallel threads within the CCI server, the output of the FIND can result in duplicate server names.

The output stem variable records have the following word delimited fields for each matching CCI application name found:

• CCI system name - Contains one to eight characters
• CCI application name - Contains 1 to 20 characters
• L/R - Indicates L=on local system and R=on remote system
• Receive status - Indicates ACTIVE or INACTIVE
• CCI release level - Contains small integer 0-255
• CCI sysplex name - Contains one to eight characters or N/A if not in CCI sysplex
• Jobname - Contains one to eight characters
• Jobid - Contains eight characters
• Receive queuing on - Contains Y/N
• Number of messages queued - Contains integer
• Number of sends to this application - Contains integer
• Number of receives from this application - Contains integer
• Specific sender CCI system name - Contains eight characters or N/A
• Specific sender CCI application name - Contains 1-20 characters or N/A