ZCPYS PROFILE: Configure the IBM Copy Services Manager server profiles

Use this command to configure the server profiles that are used to send requests to the IBM Copy Services Manager.

Last updated

Added in 2022.

Requirements and restrictions

  • You can enter this command only from the prime CRAS.
  • You can enter this command only from the basic subsystem (BSS).
  • This command requires an available Copy Services Manager that the z/TPF system can interface with. For more information, see Installing Copy Services Manager overview.

Format

Read syntax diagramSkip visual syntax diagramZCPYS PROFILE REGisterServer role parameters Register parametersSWAPCLEARServer role parametersVALidateServer role parametersDISPlayTIMEOUT- timeoutHA ENABLEDISABLE
Server role parameters
Read syntax diagramSkip visual syntax diagram ACTIVE STANDBY
Register parameters
Read syntax diagramSkip visual syntax diagram HOSTname- hostnamePORT- portnumberUSERname- usernamePASSword- password
REGister
Registers the settings to the Copy Services Manager server profile.
SWAP
Swaps the settings of the active and standby server profiles.
CLEAR
Clears the settings of the server profile.
VALidate
Sends a REST request to the Copy Services Manager to check the validity of the server profile settings.
DISPlay
Displays the server profiles and other settings for the Copy Services Manager.
TIMEOUT-timeout
Changes the HTTP client request timeout for the responses from the Copy Services Manager, where timeout is the number of seconds in the range 1 - 65535.
HA
Changes the high-availability requirement setting for the server profiles.
ENABLE
Enables the specified setting.
DISABLE
Disables the specified setting.
ACTIVE
Selects the active server profile.
STANDBY
Selects the standby server profile.
HOSTname-hostname
Specifies the hostname in the server profile, where hostname is a string that is no longer than 128 characters.
PORT-portnumber
Specifies the port number in the server profile, where portnumber is a value in the range of 1 - 65535.
USERname-username
Specifies the username in the server profile, where username is a string that is no longer than 104 characters.
PASSword-password
Specifies the password in the server profile, where password is a string that is no longer than 104 characters.

Additional information

  • Online help information is available for this command. To display the help information, enter one of the following commands:
    • ZCPYS HELP
    • ZCPYS ?
  • When the CSMP0099I message is issued in response to the ZCPYS PROFILE REGISTER PASSWORD command, asterisks (*) are displayed in place of the password. If you installed the TPF Operations Server, you can configure the password to be masked in the command area and message areas of the console based on the command syntax.

Examples

The following example registers a hostname, port number, username, and password to the Copy Services Manager server profile.
User:   ZCPYS PROFILE REGISTER HOST-9.87.654.321 PORT-9559 USER-MyUser PASS-MyPassword

System: CSMP0097I 16.35.25 CPU-B SS-BSS  SSU-HPN  IS-01
        CPYS0003I 16.35.25 THE ACTIVE SERVER PROFILE WAS UPDATED.
The following example validates the active server profile that was registered on the z/TPF system.
User:   ZCPYS PROFILE VALIDATE

System: CSMP0097I 17.23.14 CPU-B SS-BSS  SSU-HPN  IS-01
        CPYS0001I 17.23.14 A REST REQUEST IS BEING SENT TO THE COPY SERVICES MANAGER. 
        COMMAND – ZCPYS PROFILE VALIDATE
        CSMP0097I 17.23.14 CPU-B SS-BSS  SSU-HPN  IS-01
        CPYS0002I 17.23.14 THE ACTIVE SERVER PROFILE WAS VALIDATED.