Building Resources for File Transfer Products › Define Resources for File Transfer Products

Define Resources for File Transfer Products

To build an environment to manage CA XCOM Data Transport for z/OS, CONNECT:Direct, CONNECT:Mailbox, FTS, and FTP resources, you define the following:

• Manager Resources (XCMGR, CDMGR, CMMGR, FTPMGR, and FTSMGR)—You must define manager resources to your system image. This resource class is used to define your file transfer applications to the knowledge base. This is an owning resource.
• Monitor Resources (XCMON, CDMON, CMMON, FTPMON, and FTSMON)—You define monitor resources to your manager resource. This resource class is used to define resources that monitor the file transfer application. These are owned resources—you define various monitors for the manager.

Note: File transfer product resources are not available for the Generic data transfer API.

How to Define CA XCOM Data Transport for z/OS Resources

A CA NetMaster FTM region can manage CA XCOM Data Transport for z/OS applications on the local system. To enable the region to perform this management function, you must define managers and monitors for these applications in the system image.

To define CA XCOM Data Transport for z/OS resources

1. Use the Assisted Resource Definition Facility to create a manager for a CA XCOM Data Transport for z/OS application.
2. Generate monitors for the created managers.

Create a CA XCOM Data Transport for z/OS Manager

To create the resource to manage your CA XCOM Data Transport for z/OS region

1. Enter /RADMIN.AD.XC at the command prompt and do one of the following:
   • If you have defined the system image, enter S beside the system image on the displayed System Image List panel.
   • If you have not defined your system image, press Enter at the Confirm System Image Add panel to add a system image.

     The XCOM Manager General Description panel appears.

2. Complete the following fields:
   • XCOM Manager Name

     Specifies the name of the CA XCOM Data Transport for z/OS manager.

     Note: You define a manager resource for each application you want to be managed by this region. The manager name identifies the CA XCOM Data Transport for z/OS resource that is the subject of this definition. The manager name must be the same as that used for the CA XCOM Data Transport for z/OS application.

   • Manager Type

     Specifies the type of the manager:

     • STC specifies that the application is initialized as a started task.
     • JOB specifies that the application is initialized as a job.
   • ACB Name

     (Optional) Specifies the name of the VTAM ACB that must be active before this resource can start successfully.

   • Operation Mode

     Specifies the type of operation:

     • AUTOMATED specifies that the resource is monitored and controlled (activated and inactivated) by the region.
     • MANUAL specifies that the resource can be controlled manually, and the region monitors but does not automatically control the resource.
   • Short Description

     Briefly describes this resource.

     Press F3 (File).

     The manager resource definition is filed.

3. (Optional) Press F4 (Save) to save the current definition and update the definition for a new manager resource if you want to create multiple manager resource definitions. Repeat this process until a manager resource is defined for each CA XCOM Data Transport for z/OS application on this system.

   Press F3 (File).

   The ResourceView : XCOM Manager List panel appears.

4. (Optional) If you specified that the CA XCOM Data Transport for z/OS application was initiated by a job, ensure that the message text on the resource definition Display and Heartbeat Details panel is valid for your job. To do this, enter S beside the listed manager resource and select the Display and Heartbeat Details Panel from the displayed list.

This newly created resource manages your CA XCOM Data Transport for z/OS application. You can modify it at a later stage.

You have completed the CA XCOM Data Transport for z/OS manager resource definition and can now define monitor resources for the manager.

Create CA XCOM Data Transport for z/OS Monitors

To generate monitors for the created CA XCOM Data Transport for z/OS managers

1. Enter G beside a manager resource definition.

   A list of the available monitor resource types appears.

2. Enter S beside each type of monitor you want to generate for your manager resource definition.

   A panel for each monitor appears.

3. Enter the name of each monitor, and optionally, a long description of the monitor.

   Press F8 (Forward).

   The Monitor Details panel appears.

4. Review the settings and press F3 (File).

   When you have filed the details for all selected monitors, the ResourceView : XCOM Manager List appears.

   Note: If the monitor type is REQUEST-MON, the heartbeat interval is specified on the Monitor Details panel of the owning XCMGR definition.

5. (Optional) Enter G beside any remaining manager resources and repeat steps 2 through 4 to define monitor resources for the manager resources.
6. Press F3 (Exit).

   The monitor is created.

You can customize the resource definitions created by the Assisted Resource Definition Facility.

How to Define CONNECT:Direct Resources

A CA NetMaster FTM region can manage CONNECT:Direct applications on the local system and on distributed systems such as Windows. To enable the region to perform this management function, define managers and monitors for these applications in the system image.

Note: To manage CONNECT:Direct applications on a distributed system such as Windows, you must have implemented the appropriate agent for CA NetMaster FTM on that system.

To define CONNECT:Direct Resources

1. Use the Assisted Resource Definition Facility to create a manager for a CONNECT:Direct application.
2. Use the Auto Populate Facility to create the managers for its partner CONNECT:Direct applications on distributed systems.
3. Generate monitors for the created managers.

Create a CONNECT:Direct Manager

You can use the same steps to create resources to manage CONNECT:Direct on distributed systems; however, you may want to use the Auto Populate Facility to create those resources that are partners of a CONNECT:Direct for OS/390 region.

To create resources to manage CONNECT:Direct for OS/390

1. Enter /RADMIN.AD.CD at the command prompt and do one of the following:
   • If you have defined the system image, enter S beside the system image on the displayed System Image List panel.
   • If you have not defined your system image, press Enter at the Confirm System Image Add panel to add a system image.

     The C:D File Transfer Manager General Description panel appears.

2. Complete the following fields:
   • C:D File Transfer Manager Name

     Specifies the name of the CONNECT:Direct manager.

     Define a manager resource for each CONNECT:Direct application to be managed by this region.

     Note: The manager name identifies the CONNECT:Direct resource that is the subject of this definition. For CONNECT:Direct for OS/390, the manager name must be the same as that used for the CONNECT:Direct application. For CONNECT:Direct on a distributed system, the manager name must match the distributed system host name.

     Note: For more information about the distributed system host name, see the CA NetMaster File Transfer Management Agent—CONNECT:Direct Installation and Administration Guide.

   • C:D File Transfer Manager Type

     Specifies the type of manager. Enter ? to display a list of valid values.

     If the CONNECT:Direct application is …	Enter …
     Initialized as a started task	STC as the manager type and, optionally, its ACB name.
     Initialized as a job	JOB as the manager type and, optionally, its ACB name.
     On a Windows system	Windows as the manager type and the TCP/IP details of the agent.

   • ACB Name

     (Optional) Specifies the name of the VTAM ACB that must be active before this resource can start successfully.

   • TCP/IP Host Name/Addr

     Specifies the TCP/IP details of the distributed systems agent.

   • Operation Mode

     Specifies the type of operation:

     • AUTOMATED specifies that the resource is monitored and controlled (activated and inactivated) by the CA NetMaster FTM region.
     • MANUAL specifies that the resource can be controlled manually, and the CA NetMaster FTM region monitors but does not automatically control the resource.
   • Short Description

     Briefly describes this resource.

     Press F3 (File).

     The manager resource definition is filed.

3. (Optional) To create multiple manager resource definitions, press F4 (Save) to save the current definition and update the definition for a new manager resource. Repeat this process until a manager resource is defined for each CONNECT:Direct application to be managed by this region.
4. Press F3 (File).

   The ResourceView : C:D File Transfer Manager List panel appears.

5. (Optional) If you specified that the CONNECT:Direct application was initiated by a job, ensure that the message text on the resource definition Display and Heartbeat Details panel is valid for your job. To do this, enter S beside the listed manager resource and select the Display and Heartbeat Details Panel from the displayed list.

This newly created resource manages your CONNECT:Direct application. You can modify it at a later stage.

You have completed the CONNECT:Direct manager resource definition, and can now define the partner resources for the manager.

Use the Auto Populate Facility to Create Resources for Partner CONNECT:Direct Applications

The Auto Populate Facility uses the network map of a CONNECT:Direct for an z/OS region to list the partner CONNECT:Direct applications. You can then select the required applications and create the manager resources for them.

To use the Auto Populate Facility to define resources for CONNECT:Direct, you must satisfy the following:

• You have defined the CONNECT:Direct for OS/390 manager.
• The system image that contains the manager is active.
• The CONNECT:Direct for OS/390 region that owns the network map is active.
• You are an authorized user in the CONNECT:Direct for OS/390 region.

To create resources for partner Connect:Direct applications

1. Enter /RADMIN.AD.A at the command prompt.

   The Auto Populate Menu appears.

2. Type CD at the prompt and complete the following fields:
   • System Name and Version

     Specifies the name and version of the system image (to which you want to add the definitions for the local resources). Auto population puts resources for CONNECT:Direct for OS/390 and its partners in the same image.

   • Template

     Specifies the template to use to create the definitions. Type ? in the field to display a list of valid templates.

   • Resource Mask

     Restricts the list of resources that appear for which you can build definitions. Use the asterisk (*) as the wildcard character. A leading or embedded * represents a single character; a trailing * represents any number of characters. For example, **A0 includes 00A0, 01A0, … while 09* includes 09A0, 09A1, 09A2, …

   • CDMGR Name

     Specifies the manager for the CONNECT:Direct for OS/390 region for which you want to discover the partners.

     Press Enter.

     The C:D File Transfer Manager Template List panel appears.

3. Enter S beside the required template to list the type of resources you selected.

   If you are accessing the specified CONNECT:Direct for OS/390 region from the CA NetMaster FTM region for the first time, you are prompted to confirm your signon details.

   Enter your password and check that the other details are correct, then press F6 (Confirm).

   The Auto Populate Selection List panel appears.

4. Type S beside the resources for which you want to build definitions.

   Note: To select all the displayed resources, enter ALL S at the command prompt.

   Press Enter to validate your selections.

   The selections are tagged as selected.

   Note: To deselect a selected resource, enter U beside the resource. To deselect all selected resources, enter ALL U at the command prompt. You can, if necessary, change the templates for individual resources. To cancel the operation, press F12 (Cancel) before the next step.

5. Press F6 (Action).

   The resource definitions are built.

6. Enter /RADMIN.R.CDMGR at the prompt.

   The C:D File Transfer Manager List appears with the newly-created managers.

7. (Optional) If you have changed the default port number of the agents, review and update the TCP/IP details of the agents in the manager definitions.

   Define monitor resources for these managers.

You have completed the CONNECT:Direct manager resource definitions, and can now define monitor resources for the managers.

Create CONNECT:Direct Monitors

To generate monitors for the CONNECT:Direct managers

1. Enter G beside a manager resource definition.

   A list of the available monitor resource types appears.

2. Enter S beside each type of monitor you want to generate for your manager resource definition.

   A panel for each monitor appears.

   Note: The TCP/IP connections monitor is not available to a distributed systems (for example, Windows) type manager.

3. Enter the name of each monitor, and optionally, a long description of the monitor.

   Press F8 (Forward).

   The Monitor Details panel appears.

4. Review the settings and press F3 (File).

   If you are defining a TCP/IP listener task monitor for a CONNECT:Direct application that resides on a distributed system, specify the TCP/IP port number of the application and, if required, an SNMP community name defined on the distributed system. The default name is public. The specified community must include the IP addresses of the local system.

   For the TCP/IP listener task monitor to work, the SNMP agent must be active. For the TCP/IP connections monitor to work, NETSTAT must be working.

5. (Optional) Enter G beside any remaining manager resources and repeat steps 2 through 4 to define monitor resources for the manager resources.
6. Press F3 (Exit).

   The monitor is created.

You can customize the resource definitions created by the Assisted Resource Definition Facility.

How to Define CONNECT:Mailbox Resources

A CA NetMaster FTM region can manage CONNECT:Mailbox applications on the local system. To enable the region to perform this function, define managers and monitors for these applications in the system image.

Create a CONNECT:Mailbox Manager

To define a CONNECT:Mailbox manager

1. Enter /RADMIN.AD.CM at the prompt.

   The System Image List appears.

2. Do one of the following:
   • If you have defined the system image, enter S beside the system image.
   • If you have not defined your system image, press Enter at the Confirm System Image Add panel to add a system image.

     The ResourceView : C:Mailbox Resource Group Definition panel appears.

3. Complete the following fields:
   • File Server Started Task Name

     Specifies the name of the CONNECT:Mailbox VSAM file server started task that is the subject of this definition. The VSAM file server is automatically defined as the parent of the CONNECT:Mailbox manager.

   • Manager Name

     Specifies the CONNECT:Mailbox started task that is the subject of this definition.

   • ACB name

     (Optional) Specifies the ACB Name. If an ACB name is specified, CA NetMaster FTM activates the ACB during resource activation.

     Press F3 (File).

     The ResourceView : C:Mailbox Manager List appears.

This resource manages or monitors your CONNECT:Mailbox application. You can modify it at a later stage.

Create CONNECT:Mailbox Monitors

To define monitor resources for the manager

1. Enter G beside a manager resource definition on the ResourceView : C:Mailbox Manager List.

   The C:Mailbox Monitor List appears.

2. Enter S beside each type of monitor you want to generate for your manager resource definition.

   The ResourceView: C:Mailbox Monitor General Description panel appears for each monitor.

3. Enter the name of each monitor, and optionally, a long description of the monitor.

   Press F8 (Forward).

   The Monitor Details panel appears.

4. Review the settings and press F3 (File).

   The monitor resource definition is saved.

You can customize the resource definitions created by the Assisted Resource Definition Facility.

How to Define FTS Resources

To enable the region to manage CA SOLVE:FTS file transfers, define managers and monitors for the CA SOLVE:FTS applications in the system image.

Define Managers

To define managers for CA SOLVE:FTS applications in the system image

1. Enter /RADMIN.AD.FTS at the prompt.

   The System Image List appears.

2. Do one of the following:
   • If you have defined the system image, enter S beside the system image.
   • If you have not defined the system image, press Enter at the Confirm System Image Add panel to add a system image.

     The FTS File Transfer Manager General Description panel appears.

3. Complete the following fields:
   • FTS File Transfer Manager Name

     Specifies the FTS manager name.

     Note: Define a manager resource for each application you want to manage or monitor in this system domain. The manager name identifies the FTS resource that is the subject of this definition.

   • Manager Type

     Specifies the manager type:

     • SELF specifies that the application is in this region.
     • STC specifies that the application is initialized as a started task as another region on this system. The specified manager name must be the same as that used for the started task.
     • JOB specifies that the application is initialized as a job as another region on this system. The specified name must be the same as that used for the job.
     • REMOTE specifies that the application is initialized on another system.
   • Operation Mode

     Specifies the operation mode:

     • AUTOMATED specifies that the region maintains monitors and controls the resource.
     • MANUAL specifies that the resource is controlled manually; the region monitors but does not control the resource.
   • Short Description

     Briefly describes the resource, for example, FTP started task.

4. Press F3 (File).

   The resource definition is saved and the ResourceView : FTS File Transfer Manager List panel appears.

   Note: If you specified that the application was initiated by a job, ensure that the message text on the resource definition Display and Heartbeat Details panel is valid for your job. To do this, enter S beside the listed manager resource and select the Display and Heartbeat Details Panel from the displayed list.

You can modify the newly-created resource at a later stage.

Define Monitors

To define managers for CA SOLVE:FTS applications in the system image

1. Enter G beside a manager resource definition on the ResourceView : FTS File Transfer Manager List.

   The FTS File Transfer Monitor General Description panel appears.

2. Complete the following fields:
   • FTS File Transfer Monitor Name

     Specifies the name of the monitor.

3. Press F8 (Forward).

   The FTSMON Monitor Details panel appears.

4. Complete the following field:
   • Link Name

     Specifies the name of an INMC link defined in the managed CA SOLVE:FTS region (for example, the name of an FTS-to-FTS INMC link).

     Press F4 (Save).

     The monitor resource definition is saved.

5. Repeat steps 2 to 4 to define resources for each INMC link you want to monitor. You should define a monitor resource for each INMC link that is used for file transfers.
6. Press F3 (File).

   The ResourceView : FTS File Transfer Manager List appears.

7. Enter G beside any manager resource and define monitor resources for the manager resources.
8. Press F3 (Exit).

   The monitor definition is saved.

You can customize the resource definitions created by the Assisted Resource Definition Facility.

How to Define FTP Resources

A CA NetMaster FTM region can manage FTP server applications on the local system and monitor the health of FTP connections. To enable the region to perform these functions, define managers and monitors for these applications in the system image.

Note: For managers of CA TCPaccess FTP Server for z/OS, the transfer policy rule set (subject to the FTPCNTL parameter group setting) and SOLVE SSI are also monitored by this resource.

Define Managers

To define managers for FTP server applications in the system image

1. Enter /RADMIN.AD.FTP at the prompt.

   The System Image List appears.

2. Do one of the following:
   • If you have defined the system image, enter S beside the system image.
   • If you have not defined your system image, press Enter at the Confirm System Image Add panel to add a system image.

     The FTP Server Manager General Description panel appears.

3. Complete the following fields:
   • FTP Server Manager Name

     Specifies the FTP server resource that is the subject of this definition. You define a manager resource for each FTP server application you want to manage or monitor in this system domain. The following rules apply:

     • For Communications Server FTP server, ensure that the manager name is the FTP background daemon name (usually, FTPD1).
     • For CA TCPaccess CS for z/OS, ensure that the manager name is the server name.
     • For CA TCPaccess FTP Server for z/OS, ensure that the manager name is the FTP server started task or batch job name.
   • FTP Server Manager Type

     Specifies the manager type:

     • STC specifies that the FTP server is initialized as a started task
     • JOB specifies that the FTP server is initialized as a job.
   • Operation Mode

     Specifies the operation mode:

     • AUTOMATED specifies that the region maintains monitors and controls the resource.
     • MANUAL specifies that the resource is controlled manually, and the region monitors but does not control the resource.
   • Short Description

     Briefly describes the resource, for example, FTS started task.

     Position your cursor in the first input field of the Template Selection window, and enter L.

     The ResourceView : FTP Server Manager Template List appears.

4. Enter M beside the corresponding template name, as shown in the following table:

   Server or Region	Job or Started Task	Template Name
   Communications Server FTP server	Started task	CSFTPSRV
   CA TCPaccess CS for z/OS	Job	AXS52JOB, AXS53JOB, or AXSJOB
   CA TCPaccess CS for z/OS	Started task	AXS52STC, AXS53STC, or AXSSTC
   CA TCPaccess FTP Server for z/OS	Job	SFTPJOB
   CA TCPaccess FTP Server for z/OS	Started task	SFTPSTC

   A confirmation message appears.

   Note: Applying the M (Merge) action merges the values defined in the template with your resource definition. You can apply O (Override) or R (Reset) for the same effect because the resource definition has no values incorporated at this stage. See the online help for additional information about these actions.

5. Do one of the following:
   • If you are defining an Communications Server FTP server manager, On the Activation Details panel, ensure that the name in the Sys Cmd/JCL Mem field matches the FTP server started task name and continue to the next step.
   • If you are defining a manager for an FTP application initiated by a job, on the Display and Heartbeat Details panel, ensure that the message text is valid for your job and continue to the next step.
   • If you are defining other managers, continue to the next step.
6. Press F3 (Exit) and then F3 (File).

   The manager resource definition is saved and the ResourceView : FTP Server Manager List panel appears.

This newly created resource manages and monitors your FTP server application. You can modify it at a later stage.

Define Monitors

To define monitors for FTP server applications in the system image

1. Enter G beside a manager resource definition on the ResourceView : FTP Server Manager List.

   The FTP Server Monitor List appears.

2. Enter S beside each type of monitor you want to generate for your manager resource definition.

   The FTP Server Monitor General Description panel appears.

3. Complete the following fields:
   • FTP Server Monitor Name

     Specifies the name of the monitor.

     Press F8 (Forward).

     The FTPMON Monitor Details panel appears.

4. Review the settings and press F3 (File).

   The monitor definition is saved.

5. Enter G beside any remaining manager resources to define monitor resources for the manager resources.
6. Press F3 (Exit).

   The ResourceView : FTP Server Manager List appears.

You can customize the resource definitions created by the Assisted Resource Definition Facility.