Transfer services

Transfer services allow actions to be taken on transfers with the security system performing an authorization check when the request is submitted, and not when the request is processed by the monitor, the behavior of unprotected IPC with an error message in the log file.

The application can detect commands that do not have permission for access. This lightens the workload, improving Transfer CFT performance, and reducing the cluttering of the communication medium by invalid requests.

Call syntax

rc =      cftau (verb,param)

rc =      cftac (verb,param)

Where:

  • cftau indicates that syntax analysis is requested
  • cftac indicates that syntax analysis is not requested
  • <verb> is the command that you want to process
  • <param> is a character string of variable length that contains the command parameters. The end of the field is defined by a character initially set to low-value
  • <rc> is the return code

The available <verbs> are listed in the following table.

<verb>

Service

SEND

Send

RECV

Receive

HALT

Interrupt

KEEP

Suspend

START

Retry

DELETE

Delete

END

Proceed to "X" state

SUBMIT

Re-submit end-of-transfer procedure

SHUT

Stop monitor

SWITCH

Switching monitoring files
(log, statistics file)

COM

 

For more information on the parameter syntax for each command, refer to the Command index.

If <param> is not defined, CFTU will take a default name.

As these media are not available on all systems, the function performs an availability check.

The security check is performed on the user name, and the user group if applicable, depending on the command:

  • IDF if present in parameter field: DELETE, END, HALT, KEEP, SEND, RECV, START
  • Procedure name: SUBMIT
  • Type: SWITCH LOG or ACCNT

Return codes

Mnemonic

Description

CAPI_NOERR

No error

CAPI_FUNC_UNDEF

Command not valid

CAPI_CMD_LENGTH

cftau only

Transfer CFT command string invalid, does not exist, or greater than 1024 characters long 

CAPI_KEY_NAME

cftau only

Command syntax incorrect: keyword name incorrect

CAPI_KEY_VALUE

cftau only

Command syntax incorrect: keyword value incorrect

CAPI_MEM_GET

Memory allocation error

CAPI_MEM_FREE

Memory de-allocation error

CAPI_INT_ERR1

Internal error 1

CAPI_INT_ERR2

Internal error 2

CAPI_INT_ERR3

Internal error 3

Error messages

The FIELD and MSG fields of the CFTAPI COPY CLAUSE contain:

  • FIELD: name of the incorrect parameter detected by the Transfer CFT syntax analyzer
  • MSG:
    • Either a message relative to the error recognized by the syntax analyzer
    • Or an error message describing an incident when the command is taken into account

See Messages and error codes .

If no error is detected, the FIELD and MSG fields are blank.

Related Links