SET_TARGET_FILENAME_EXTERNAL

Use SET_TARGET_FILENAME_EXTERNAL to set the target file name using an external format instead of the internal (FNAME) format. This function will take both a three part NSK name or a multi part ANSI name. However, an ANSI name is not allowed if the Extract is also using the MAP option of USEREXITNAMEMAP.

Valid only for Extract.

Syntax

For C:

#include "usrdecs"
short result;
char *filename;
short filename_len;
result = SET_TARGET_FILENAME_EXTERNAL (char *filename, short filename_len);

For TAL:

?source usrdect
int result;
string .ext filename_name;
int .filename_name_len;
result := SET_TARGET_FILENAME_EXTERNAL (filename_name, filename_name_len);

For COBOL:

?CONSULT =EXTRACT
01 result PIC S9(4) COMP.
01 filename PIC x(48).
01 filename-len PIC S9(04) COMP.
ENTER C "GET_COLUMN_NAME" using filename, filename-len, max-name-len,
source-or-target giving result.

filename

The name of the current record's file to be set.

filename_len

The size of the name to be set.

result

A code indicating whether the call was successful or not.