Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Tools : UNLOADLIBRARY

UNLOADLIBRARY
Unloads all rules in the specified library at the specified location to a z/OS data set or a Windows or Solaris file. (C)
Invocation
CALL UNLOADLIBRARY(library, location)
 
Usage Notes
If the output is going to…
Allocate a data set with these characteristics: RECORD FORMAT - VB, LRECL - 2250 or larger. It can be a partitioned data set. You must call @OPENDSN to set up the destination data set.
Use @OPENDSN to set up the destination file. Specify either the full path or only the filename. If you specify only the filename, the DSDIR Execution Environment parameter must be set to point to the directory to use. Refer to TIBCO Object Service Broker Parameters for more information about this parameter.
Specify a filename in uppercase. Use @OPENDSN to set up the destination file. Specify either the full path or only the filename. If you specify only the filename, the DSDIR Execution Environment parameter must be set to point to the directory to use. Refer to TIBCO Object Service Broker Parameters for more information about this parameter.
Use $SETPRINT/$RESETPRINT to set up a destination for status messages.
If you are using FTP to transfer unloaded data between z/OS and Windows or Solaris, it is no longer mandatory to use the S6BBRFRU z/OS utility before the data can be used by TIBCO Object Service Broker. Refer to TIBCO Object Service Broker for z/OS Utilities for more information about S6BBRFRU.
Example
The following rule unloads all the files from the specified library and writes an end message at completion:

 
UNLOADLIBRARY_1(FILE);
_
_ ---------------------------------------------------------------------------
_ ------------------------------------------------------------+--------------
_ CALL @OPENDSN(FILE); | 1
_ CALL $SETPRINT(10, 45, 1, 'SCR', 'N'); | 2
_ CALL UNLOADLIBRARY('USR40', ''); | 3
_ CALL ENDMSG('THE OUTPUT HAS BEEN DIRECTED TO ' xx 'SCR'); | 4
_ ---------------------------------------------------------------------------

 
Resulting Output
After running this rule, the following message appears in the message log:

 
-------------------------- INFORMATIONAL MESSAGE LOG -----------------------------
COMMAND ===> SCROLL ===> P
 
 
----------------- NEW PAGE ------------------
 
Page 1
Unloaded 14 rules from library USR40

 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved