In z/OS, a distinction must be made between an account number and accounting information.
An account number may not contain blanks, tabs, double quotes, single quotes, semicolons or line control characters; brackets are permitted only in pairs.
If an account number contains only letters, digits and the metacharacters @, $, #, it can be specified without single quotes.
If it contains additional metacharacters (which must comply with the restrictions named), it must be enclosed within quotes.
Examples
The account number A123$4 can be specified without quotes.
The account number A(123) must be entered as ’A(123)’ (this means, for example, as c'''A(123)''' in the NCOPY command, determined by the data type c-string).
Accounting information consists of an account number (string before the first comma), which must comply with the syntax specified above, and additional specifications with any number of characters.
openFT checks only the string before the first comma for validity with the SYS1.UADS or with RACF.
Accounting information must be specified in accordance with IBM-JCL conventions. Basically, it is necessary to ensure that quotes in the accounting information are enclosed when they are received and that the quotes are not evaluated - and deleted - when the command is entered.
If the account number (string before the first comma) contains metacharacters other than @, $, #, the entire accounting information must be specified in triple quotes.
Example
The accounting information 123$#@,ABC,12/90 can be specified as '123$#@,ABC,12/90' in accordance with IBM-JCL conventions.
At the menu interface of openFT (z/OS) and the graphical user interface of openFT (BS2000), you enter this accounting information as '123$#@,ABC,12/90'.
In an FT request issued in z/OS or BS2000, the specification is c'''123$#@,ABC,12/90'''
At the graphical user interface of openFT for Windows or for Unix systems: '123$#@\,ABC\,12/90'
In a command issued under Windows, enter:
'123$#@\,ABC\,12/90'
In a Unix system, the following must be specified in the command:
\''123$#@\,ABC\,12/90'\'
When you issue an FT request, you initiate three processes in the local and remote system that are accountable:
initiation of file transfer by means of the NCOPY command,
the file transfer itself, and
any follow-up processing performed.
Initiation of file transfer by means of the NCOPY command is implemented in an interactive or a batch job accounted as usual.
Follow-up processing in the local and remote systems is charged by FT systems to the accounts whose account numbers are specified in the local and remote PROCESSING-ADMISSION of the file transfer request.
openFT (z/OS) also enables the file transfer itself to be accounted. If the FT administrator sets openFT accordingly, an accounting record is written to the SMF file for each transfer request accepted, provided that SMF (System Management Facilities) is active. This applies to transfer requests issued in the local system and in remote systems. The computer center can evaluate these accounting records using accounting programs. Accounting records can only be written if the openFT is "APF authorized"; please consult your FT administrator. The structure of the accounting records is described in the manual "openFT (z/OS) - Installation and Operation".
Default account number
Both the actual file transfer and the follow-up processing can be charged to the default account number of the user ID which is specified in the TRANSFER-ADMISSION or PROCESSING-ADMISSION. For this to be possible, the following requirements must be satisfied:
No account number is specified in the TRANSFER-ADMISSION or PROCESSING-ADMISSION.
The RACF database must contain a default account number for the user ID specified in the TRANSFER-ADMISSION or PROCESSING-ADMISSION (this can be recognized, for example, by the fact that this account number appears in the TSO welcome screen).This account number may not exceed 40 characters.
The RACF resource class ACCTNUM is active.
The SYS1.UADS data set is not available.
For information on the last two points, please contact your FT administrator or z/OS system administrator.