Previous Topic
Table Of Contents
Parent Topic
Next Topic

The SWSCONCT Function

Related Topics

Web Server API Function Index

	Can be used in Shadow/REXX
	Can be used from Other REXX Interpreters
	High-level Language Interface available

The REXX-language SWSCONCT built-in function can be used to concatenate multiple ddnames of previously allocated datasets. Datasets concatenated using the SWSCONCT built-in function may use the SWSDECON built-in function to de-concatenate the DDName.

Note: Because of comparable functionality of SWSCONCT to IBM's CONCAT function, this documentation is similar to IBM's TSO/E online help.

SWSCONCT Syntax

The format of this command is similar in features and functions to the TSO/E CONCAT command.

If an error occurs, the REXX variable, ALLOC.MESSAGE, will be populated with a descriptive message. The DAIR return code may be obtained from ALLOC.INFOCODE and the reason code may be obtained from the ALLOC.REASON.

The general form for a REXX-language invocation of SWSCONCT is:


   rc = SWSCONCT("STRING")

DDN(DD1 DD2 DD3 ...)

Specifies a list of previously allocated ddnames to be concatenated together.

Note: Separate parameters by spaces. Do not use commas.

The datasets will be concatenated as a single DDName using the first DDName in the list.

PERM(VALUE)

Specifies whether or not to permanently concatenate these DDNames. Files that are permanently concatenated may not be "de-concatenated".

Legitimate values are:

YES = Permanently concatenate these files.
NO = Do not permanently concatenate these files.

Note: The default is NO

SWSCONCT Examples

 
    To concatenate multiple ddnames
 
    rc = SWSCONCT(DDN(INFILE1 INFILE2))

Top