Commands › MGRADDR Command: Specify Scheduling Manager's Address

MGRADDR Command: Specify Scheduling Manager's Address

To notify one or more scheduling managers of the address of z/OS Agent, use the MGRADDR command. The MGRADDR command enables the scheduling manager to know which agent receiver to connect. The address is always sent automatically.

Type: OPER command

Authority: To issue the MGRADDR command, you require OPER authority.

This command has the following format:

MGRADDR {MANAGER|MANAGER(managername)[PORT(port)] [PERSISTENT(YES|NO)]}
        {DISPLAY}
        {HELP}
        {LIST}

MANAGER

Sends a notification to all the scheduling managers.

MANAGER(managername)

Indicates the unique name of the scheduling manager, as defined in the scheduling manager topology. To specify multiple scheduling managers, use the hyphen wildcard.

PORT(port)

Notifies a scheduling manager of the agent receiver port number to connect.

PERSISTENT(YES|NO)

Indicates a permanent or temporary change on the scheduling manager.

YES

Specifies to save (permanently) z/OS Agent address and receiver port number on the scheduling manager. The YES operand enables the scheduling manager to know the receiver to connect when required.

NO

Indicates z/OS Agent address and receiver port number only change temporarily on the scheduling manager. The address and port number are reset to the values defined in the scheduling manager topology the next time the scheduling manager restarts. The NO operand is the default.

DISPLAY

Displays the address and home TCP/IP address of the local z/OS Agent. They are the same if the TCPIP operand is specified in the ZOSAGENT initialization parameter.

HELP

Displays the MGRADDR command options.

LIST

Displays the address and home TCP/IP address of the local z/OS Agent. They are the same if the TCPIP operand is specified in the ZOSAGENT parameter of the agent definition file.

Note: The MGRADDR command is useful when z/OS Agent is stopped on one system and started on another because the TCP/IP address changes. MGRADDR tells the scheduling manager to respond to messages from z/OS Agent on a new TCP/IP address and port. You can issue the MGRADDR command only from the new system.

Use the MGRADDR command when you move z/OS Agent to a new system. This change is temporary until the agent restarts. If the change is permanent, issue the MGRADDR command with the PORT(port) and PERSISTENT(YES) operands.

Note: You can also issue the AGENTMSG command with the MGRADDR verb from the original system or from the new system.

Example: Display z/OS Agent Address

To display the address and home TCP/IP address of the local z/OS Agent, enter one of the following commands:

• MGRADDR
• MGRADDR DISPLAY
• MGRADDR LIST

Example: Notify All Scheduling Managers

These two examples show how to send a notification to all the scheduling managers.

MGRADDR MANAGER
MGRADDR MANAGER(-)

Example: Notify Multiple Scheduling Managers

This example shows how to send a notification to scheduling managers with the name prefix AUTO.

MGRADDR MANAGER(AUTO-)

Example: Specify Port Number

This example shows how to send a notification to the scheduling manager AUTOSYS1 and inform the scheduling manager to connect to agent receiver TCP/IP port 5451.

MGRADDR MANAGER(AUTOSYS1) PORT(5451)

Example: Permanently Change z/OS Agent's Address and Port Number on the Scheduling Manager

This example shows how to send a notification to a scheduling manager called AUTOSYS1, informing it to connect to agent receiver TCP/IP port 5451. The information is permanently saved in the AUTOSYS1 scheduling manager so the scheduling manager knows which receiver to connect when required.

MGRADDR MANAGER(AUTOSYS1) PORT(5451) PERSISTENT(YES)