Customize
NetMaster FTM

After you have performed the common customization tasks to nwmft, perform the following unique customization tasks for the product:
nwmscl122
Required roles: systems programmer
Update and Review the Unique Fast Customization Parameters for
NetMaster FTM
When you performed the common customization tasks for
NetMaster FTM
, you updated and reviewed the common fast customization parameters for all
NetMaster
products. Next, update and review the unique fast customization parameters for
NetMaster FTM
, as follows:
Implement the TCP/IP Sockets Interface Parameters
This procedure enables TCP/IP support. Access to sockets interfaces requires UNIX System Services authorization, which should have been done via the section Prepare IBM Communications Server (TCP/IP and FTM Only).
  1. Enter
    U
    next to the TCP/IP Sockets Interface parameter group.
    The first SOCKETS - TCP/IP Sockets Interface panel appears.
  2. Tab to the
    TCP/IP Interface Type
    field, and enter the required value.
    Only one type of TCP/IP software can be configured as the sockets interface in each region.
  3. Specify an
    Inbound Connections Port
    The Inbound Connections Port field contains a default port number. The port number must be unique for each system. If another region on this system is already using that number, update the field.
  4. Specify the
    Retry Interval
  5. Press F8.
    The second panel for this parameter group appears.
  6. Enter the
    TCP/IP Job Name
    or the
    TCPIP.DATA.DSN name
    .
  7. Enter the
    Work Data Set Name
  8. Press F6 (Action) to set the specified values and start the interface.
  9. Press F3 (File) to save your settings.
  10. Press F3 (Exit).
    The System Parameters panel appears.
Implement File Transfer Mechanism Parameters
If you are licensed for CONNECT:Direct or CONNECT:Mailbox, the fast setup displays the following interface parameters:
  • CDAPI -- CONNECT:Direct
  • CMAPI -- CONNECT:Mailbox
To implement file transfer mechanism parameters:
  1. Enter
    U
    beside the required parameter group (either CDAPI or CMAPI). The selected panel appears.
  2. Complete the fields on this panel. Press F1 (Help) for more information.
  3. Press F6 (Action) to action the entries.
  4. Press F3 (File) to save your settings.
    The Customizer : Fast Setup panel appears with the Reviewed column marked Yes for each updated field.
  5. Repeat these steps for the other parameter group.
Update and Review Additional File Transfer Mechanism Parameter Groups for
NetMaster FTM
To begin the process of updating and reviewing other customization parameters, open the System Parameters panel, and select Custom Setup or Complete Setup. Update and review the following parameter groups:
If you are using
XCOM Data Transport
or a file transfer application that interfaces with
NetMaster FTM
through the generic event API, you need to review and update the appropriate parameter group:
  • XCOM Data Transport
    interface parameters - XCAPI
  • Generic API interface parameters - GEAPI
You must reassemble your NMFT Generic Support API code if you use an IPv6 address as the source or target node address.
To update the parameters:
  1. Enter
    U
    beside the required parameter group.
    The selected panel appears.
  2. Complete the fields on this panel. Press F1 (Help) for more information.
  3. Press F6 (Action) to action the entries.
  4. Press F3 (File) to save your settings.
    The Customizer : Fast Setup panel appears with each updated field marked as YES.
  5. Repeat these steps for the other parameter group.
To set up a generic file transfer product to work with this product, see Administrating.
Customize Region for FTP Events
Use this procedure to enable the flow of FTP events to and the receipt of the events in your region.
  1. Access the FTPCNTL parameter group.
  2. To monitor the IBM FTP Server:
    1. Verify that you have prepared your TCP/IP interface for the IBM Communications Server.
      The FTP event flow to the region is enabled.
    2. For the FTPCNTL parameter group, set the following options:
      • Enable FTP Event Receiver = YES.
      • FTP Transfer ID = FTPXFER.
  3. Press F6 (Action).
    Your changes are implemented.
Define File Transfer Resources to Your Region
This task partially builds your file transfer management environment.
If you are using this product for the first time, use the File Transfer Assisted Resource Definition Facility. The facility provides default parameter values that determine how and when automation will operate.
To use the File Transfer Assisted Resource Definition Facility:
  1. At the AutoAssist Setup panel, enter
    S
    beside the File Transfer Assisted Resource Definition option.
    The Assisted Resource Definition panel appears. (If you are using a model 2 terminal, press F8 to scroll forward to select the option.)
  2. Define the file transfer resources.
    For more information about how to define resources, see Administrating.
Define the Region as a
SOLVE:FTS
User
You can enable the product region to execute commands in the managed
SOLVE:FTS
regions.
To define a region as a
SOLVE:FTS
user, complete the following steps:
  1. Define its BSYS background user in each of the
    SOLVE:FTS
    regions by copying its user ID definition,
    xxxx
    BSYS.
  2. In the product region, enter CMD at a command prompt to access the Command Entry panel.
  3. Enter SHOW USERS to list the users who are currently logged on to the region and find the ID of the BSYS background user.
Review Region Status
After you complete the initial product customization, review the status of your region to verify that it is ready for use.
  1. Enter the SELFTEST command on the OCS panel at the command prompt.
    A summary of region configuration details appears.
  2. Verify that the information that appears is as expected based on the customization that you have performed in this section.
    Red text indicates an error, and yellow text indicates a warning.
  3. Address any errors or warnings by reviewing the customization steps that you previously performed to ensure that you have
    not
    missed any steps.
For more information about how to perform a self-test, see the Administrating. topics in the
NetMaster NM for TCP/IP
documentation.
Automation for File Transfer Schedule Monitors
Use the Additional Details panel of an FTSCHD-class file transfer schedule monitor resource when automating schedule activities.
Business Value:
NetMaster FTM
encourages the automation of manual processes. Coding of automation is expensive in terms of time, effort, and maintenance when point solutions are developed. The Additional Details panel stores specified text as variables that you can use in a generic process. Building automation using generic processes enables one piece of automation code to be used for multiple resources.
Additional Considerations:
The definition for a file transfer schedule monitor resource includes an Additional Details panel, where you can add 16 lines of free-format text. Values entered at this panel are available to processes as variables, &ZRMDBADDET1 through &ZRMDBADDET16. Each line can hold 70 characters of text. The Additional Details panel supplements other panels whereby resource data is made available to automation processing.
Monitoring of file transfer schedules is often closely related to batch processing. A good use of this panel is to standardize areas of this panel for use in building generic automation for batch processing, for example:
  • Use Line 1 to specify the prerequisite suite of batch jobs.
  • Use Line 2 to specify the contact details (for example, name and telephone number) for the prerequisite jobs.
  • Use Line 3 to specify the post-processing suite of batch jobs.
  • Use Line 4 to specify the contact details for the post-processing jobs.
Your automation process can use &ZRMDBADDET1through &ZRMDBADDET4 to ascertain batch processing details, and you can define one generic process to manage all file transfer schedules.
More Information:
For more information about how to define processes, see the Administrating topics in the
NetMaster NM for TCP/IP
documentation.