NSHOW - Display remote file attributes

The macro NSHOW can be used to view the attributes of a file or directory in an FT partner system. The functionality corresponds to that of the command SHOW-REMOTE-FILE-ATTRIBUTES.

Format of the macro NSHOW (LIST format/default format)

Name	Operation	Operand
[name]	NSHOW	[MF=L,] PARTNER=adr [,FILE={*NOTSP /adr / *DIR}]        [,DIR={*NOTSP / adr}] [,FPASS={*NONE / adr}] [,TAD={*NONE / adr}] /     [,UUSER={adr}]     [,UACC={*NONE / adr}]     [,UPASS={*NONE / adr}] [,INFO={[*]STD / [*]ALL / [*]ONLY}] [,OUTPUT={[*]SYSOUT / [*]SYSLST}] [,MSGINS={*NONE / adr}] [,AFPASS={[*]GRAPH / [*]OCTET}] [,ATAD={[*]GRAPH / [*]OCTET}] [,AUPASS={[*]GRAPH / [*]OCTET}] [,LAYOUT={[*]STD / [*]CSV}] [,={[*]GRAPH / [*]OCTET}] [,={[*]GRAPH / [*]OCTET}] [,Version={1 / 2}]

The operands AFPASS, ATAD and AUPASS are used to set the coding type of the file password (FPASS), the transfer admission (TAD) and the user password (UPASS). The operands AFPASS, ATAD and AUPASS can have the value GRAPHIC or OCTET.

With GRAPHIC, the entry for the corresponding operand is interpreted as a printable character, and will be converted during transfer to a system which does not use EBCDIC. With OCTET, it is interpreted as binary information and will not be converted.

 

Format of the macro NSHOW (DSECT format)

Name	Operation	Operand
[name]	NSHOW	MF=(D[,xxx])

The prefix xxx (default value YNW) may be up to 3 characters long. It must generate names which are permitted in ASSEMBLER. The following ASSEMBLER instructions are generated:

xxxNSHW  DSECT
xxxHSHW  FHDR  MF=(C,&P)
xxxPART  DS    A                    A(PARTNER-SYSTEM)
xxxPARTL DS    XL2                  L(PARTNER-SYSTEM)
xxxFILEL DS    XL2                  L(FILE-NAME)
xxxFILE  DS    A                    A(FILE-NAME)
xxxDIR   DS    A                    A(DIRECTORY)
xxxDIRL  DS    XL2                  L(DIRECTORY)
xxxFPASL DS    XL2                  L(FILE-PASSWORD)
xxxFPAS  DS    A                    A(FILE-PASSWORD)
xxxTAD   DS    A                    A(TRANSFER-ADMISSION)
xxxTADL  DS    XL2                  L(TRANSFER-ADMISSION)
xxxUUSL  DS    XL2                  L(USER-IDENTIFICATION)
xxxUUS   DS    A                    A(USER-IDENTIFICATION)
xxxUAC   DS    A                    A(USER-ACCOUNT)
xxxUACL  DS    XL2                  L(USER-ACCOUNT)
xxxUPAL  DS    XL2                  L(USER-PASSWORD)
xxxUPA   DS    A                    A(USER-PASSWORD)
xxxMSG   DS    A                    A(MESSAGE)
xxxMSGL  DS    XL2                  L(MESSAGE)
*
xxxIFILE DS    XL1                  FILE-NAME: NOTSP / DIR
xxxIDIR  DS    XL1                  DIRECTORY: NOTSP
*
xxxIFPAS DS    XL1                  FILE-PASSWORD: NONE
xxxITAD  DS    XL1                  TRANSFER-ADMISSION: NONE / PAR
xxxIUAC  DS    XL1                  USER-ACCOUNT:  NONE
xxxIUPA  DS    XL1                  USER-PASSWORD: NONE
*
xxxOUTPT DS    XL1                  OUTPUT: SOUT / SLST / SOUTC / SLSTC
xxxINFO  DS    XL1                  INFORMATION: STD / ONLY / ALL
xxxAPAS  DS    XL1                  TYPE-FILE-PASSWORD: GRAPH/OCTET
xxxATAD  DS    XL1                  TYPE-TRANSFER-ADMS: GRAPH/OCTET
xxxAUPA  DS    XL1                  TYPE-USER-PASSWORD: GRAPH/OCTET
xxxRESRV DS    XL3                  RESERVED
*
xxxRESRV DS    XL59                 RESERVED
*
xxxRBUF  DS    A                    A(RETURNING OUTPUT)
xxxRLEN  DS    A                    IN: A(OUTPUT LEN) OUT: A(INFO LEN)
xxxCALLB DS    A                    A(CALLBACK ROUTINE)
xxxFUD   DS    A                    A(FURTHER DETAILS)
xxxLFUD  DS    XL2                  L(FURTHER DETAILS)
*
xxxLNSH  EQU   *-xxx.NSHW

Meaning of the fields

The meaning of the parameters in the macro correspond to the meaning of the parameters in the command SHOW-REMOTE-FILE-ATTRIBUTES. Please refer to the corresponding command description in the manual "openFT (BS2000) - Command Interface ".
In the OUTPT address field, SOUT stands for OUTPUT=*SYSOUT in the command, and SLST stands for OUTPUT=*SYSLST. SOUTC and SLSTC stand for their respective outputs in CSV format (LAYOUT=*CSV). For the other two values, output is in the standard format (LAYOUT=*STD).

Operand (L format)	Address field (D format)	Meaning in command
PARTNER	PART	PARTNER-NAME
FILE	FILE	FILE-NAME
DIR	DIR	DIRECTORY
FPASS	FPAS	PASSWORD
TAD	TAD	TRANSFER-ADMISSION
UUSER	UUS	USER-IDENTIFICATION in the structure TRANSFER-ADMISSION
UACC	UAC	ACCOUNT in the structure TRANSFER-ADMISSION
UPASS	UPA	PASSWORD in the structure TRANSFER-ADMISSION
INFO	INFO	INFORMATION
OUTPUT	OUTPT	OUTPUT
LAYOUT	OUTPT	LAYOUT
MSGINS	MSG	Return value of the call
AFPASS	APAS	Coding of the FPASS (GRAPHIC or OCTET)
ATAD	ATAD	Coding of the TAD (GRAPHIC or OCTET)
AUPASS	AUPA	Coding of the UPASS (corresponding to GRAPHIC or OCTET)
VERSION	FCTV	(Type of return code output (old/new))1

¹Depending on the value of the VERSION operand, the FUNCTION INTERFACE VERSION NUMBER is set in the header FHDR.