Windows Sysopts Syntax

Syntax

sysopts="datatype(text | binary)

user_data

xlate(no | yes)

xlate.tbl(pathname/filename)

strip.blanks(yes | no)

strip.oneable(yes | no)

codepage=(source codepage, destination codepage)

acl(operation,rightslist,accountname

[;operation,rightslist,accountname

[operation,rightslist,accountname [;...]])

attributes(physattr)"

datatype(text|binary)

specifies the type of data contained within the file.

• text indicates it is a text file and that trailing blanks will be stripped unless you specify strip.blanks(no). Translation of the data is performed unless you also specify xlate(no). The default is text for all nodes, except Microsoft Windows nodes. The following list shows the default source file attributes assigned for Microsoft Windows text files, which are used if necessary by the remote Sterling Connect:Direct node:
• dsorg=ps (physical sequential organization)
• recfm=vb (variable-length records, blocked if the destination operating system supports it)
• lrecl=23036 (maximum record length of 23036)
• blksize=23040 (maximum block size of 23040, if the destination operating system supports record blocking)
• binary indicates the file contains binary data. The default is binary for Microsoft Windows nodes. The following shows the default source file attributes assigned for Microsoft Windows binary files, which are used if necessary by the remote Sterling Connect:Direct node:
• dsorg=ps (physical sequential organization)
• recfm=u (undefined record format)
• lrecl=0 (undefined record length)
• blksize=23040 (maximum block size and record size of 23040)

user_data

specifies any user-defined data to be passed to the open exit dynamic link library (DLL) specified by the user, when the file is opened. The value defined for user_data is limited to a maximum of 511characters and cannot contain a closing parenthesis ‘)’ character.

strip.blanks(yes | no)

determines whether trailing blank characters at the end of each record are removed from a line of text before it is written to the Microsoft Windows text file.

strip.oneable(yes | no)

strips ^Z from the end of old DOS files. If this character is not stripped from old DOS files, Sterling Connect:Direct for Microsoft Windows translates ^Z into 3F when files are sent to the snode.

• yes removes ^Z from the end of old DOS files.
• no does not remove ^Z from the end of old DOS files. This is the default value.

Because this parameter applies to text file transfers only, be sure to specify datatype (text) and strip.oneable (yes) in sysopts to strip the character from the end of the DOS file.

xlate(no | yes)

indicates whether character translation should be performed using the default or user-supplied translation table. Typically, this translation is between ASCII and EBCDIC.

• no specifies the translation should not be performed. The default for Microsoft Windows and all other nodes with the exception of z/OS, VM, VSE, and i5/OS is no.
• yes specifies the translation should be performed. The default for z/OS, VM, VSE, and i5/OS nodes is yes.

xlate.tbl(pathname/filename)

specifies that a different translation table from the default table used by Sterling Connect:Direct is used. pathname/filename should identify a translation table created using the translation table editor of the Sterling Connect:Direct Requester for Microsoft Windows. The path specification is optional. If the path is not provided, the path specified by the xlate.dir initialization parameter is assumed for the filename specified.

codepage=(source codepage, destination codepage)

The sysopts subparameters valid only in the to clause are:

acl(operation,rightslist,accountname

[;operation,rightslist,accountname[;operation,rightslist,accountname[;...]])

specifies the users or groups allowed or denied access to a file being created by the copy operation. This subparameter is ignored if specified for a file that already exists.

operation specifies whether the rights are allowed or denied. Valid values are:

• allow
• deny

rightslist specifies the type of rights allowed or denied. Valid values are:

• read
• write
• execute
• delete
• all

The rights values can be combined by linking them with the + sign.

accountname specifies the name of the user or group to which access is allowed or denied. Multiple-user rights may be specified with each group enclosed in parentheses and delimited by a comma.

attributes(physattr)

specifies the physical attributes of the file when it is created.

physattr can include the following attributes (case sensitive):

• A (Archive Needed)
• H (Hidden)
• R (Read Only)
• S (System)