3.3 Starting NDMA

Before starting NDMA, ensure that the SNAP-IX software is started on the Solaris computer, and that the SNAP-IX node is active. Refer to the SNAP-IX Administration Guide for more information if necessary.

To start NDMA, type the following at the Solaris command prompt:

snandm [-t filename] [-p] [-c] [-n] [-s] [-b blocksize] [-r recordlength] [-l LU name]

The -t option is used to specify a code conversion file. If you include -t it must be followed by a conversion file name (with or without a directory path). Each conversion file must contain 32 lines of 32 hex digits. This information is used to set up the ASCII-EBCDIC mapping tables that NDMA will use. Use this option if you do not wish to use the default translation table which is listed in Default Translation Table.

The -p option specifies that NDMA will run CLISTs (command lists) in a separate Solaris process group. This option should only be used if your CLIST contains a command to terminate NDMA, or any part of your SNA node. In general this is not recommended as the response from this CLIST command will not be sent to the host (once part of the node has been terminated) and so when NDMA is restarted, the CLIST will be retried automatically.

The -c option specifies that binary CLISTs are being used (rather than EBCDIC). This option bypasses the translation tables and should be used if you are preparing CLISTs on Solaris machines, which will be stored as ASCII files on the mainframe computer.

The -n option specifies that a newline character will be inserted after each record in the CLIST. This option should be used if you are storing the CLISTs on a mainframe computer in a fixed block or partitioned dataset, which does not store newline characters so that the CLIST is transferred without record separators.

The -s option specifies that files sent and received are binary (rather than EBCDIC). This option bypasses the translation tables. This option is ignored for node types of PDOS and POSC where the file type can be configured on the mainframe computer.

The -b option specifies the logical block size that NetView DM will use when retrieving files from the Solaris computer. This value must not exceed 65,535 (2¹⁶-1). The default block size is 256 bytes. For more information about how this value is used, refer to your NetView DM documentation.

The -r option specifies the record length that NetView DM will use when retrieving files from the Solaris computer. This value must not exceed 2³²-1. The default record length is 256 bytes. For more information about how this value is used, refer to your NetView DM documentation.

The -l option specifies the LUA LU name that is configured for NDMA to use to communicate with NetView DM. The default LU name is NDMA.

The program displays a copyright message, followed by a status message indicating whether initialization was successful. When the host starts the NetView DM session, a further message is displayed to indicate this.