If you experience transcoding errors when you execute the %%OMABAKUP macro to back up your SAS^® metadata repositories, you should download the enhanced version of the macro definition and run the associated .sas script that is available on the Downloads tab of this note.

This new encoding–enhanced version of the SAS 9.1.3SP4 macro will dynamically sense the current session encoding, and set the appropriate value in the XML header necessary to exchange repository metadata between the server and the SAS session in which the macro is running.

The current SAS 9.1.3SP4 macro runs in ASCII format in UNIX and Windows SAS sessions, and only runs in the default EBCDIC English–US1047 (W0) code page in a z/OS environment. In most instances, the original SAS 9.1.3SP4 version of %OMABAKUP runs successfully on UNIX and Windows platforms. However, occasionally special characters used by a particular locale can cause transcoding errors. In these instances, this new macro should be used instead. The new SAS 9.1.3 macro supports backup and restore in a z/OS environment, regardless of which EBCDIC code page is used for the local SAS installation.

The omabakup913EncodingScript.sas script file has also been provided to illustrate how the new backup macro should be invoked. This script file creates a fileref to the omabakup913Encoding.sas macro file with the option ENCODING="utf8", and uses a %INCLUDE statement to specify the fileref that points to the macro that you want to be read in the current SAS session. Reading the macro file with utf8 encoding causes SAS to execute the macro using whatever session encoding is currently running.

In order to implement the new %OMABAKUP macro and script, follow these instructions:

1. Save either the fusion_34919_1_omabakup913Encoding.ZIP file or the fusion_34919_2_omabakup913Encoding.tar file from the Downloads tab of this SAS Note to an accessible location on a Windows– or UNIX–based machine.
2. Extract the omabakup913Encoding.sas and omabakup913EncodingScript.sas files by either opening the ZIP file in WinZip and extracting them (on a Windows platform) or submitting the following command on an UNIX platform:
   tar -xvf fusion_34919_2_omabakup913Encoding.tar
3. Edit the omabakup913EncodingScript.sas file to fill in the appropriate %OMABAKUP parameters and server connection options necessary to run the macro in your metadata server environment.
4. If your metadata server runs in a z/OS environment, upload the files from the Windows or UNIX machine to the mainframe machine as follows:
   1. On the Windows or UNIX host, change directory to the directory where your modified files are located.
   2. Connect to your z/OS machine with FTP.
   3. Transfer the files to the HFS filesystem on z/OS using the following commands:
      1. Change directory to the appropriate directory in the HFS filesystem.
      2. Enter: binary
      3. Enter: put omabakup913Encoding.sas
      4. Enter: ascii
      5. Enter: put omabakup913EncodingScript.sas
      6. Enter: quit
   4. Confirm the files now reside in the directory on the z/OS filesystem.

Note: You must use the syntax supplied in the omabakup913EncodingScript.sas file to submit the enhanced –OMABAKUP macro in order for the macro to execute successfully.

Operating System and Release Information

Product Family	Product	System	SAS Release
			Reported	Fixed*
SAS System	SAS Metadata Server	Microsoft Windows Server 2003 Enterprise 64-bit Edition	9.1 TS1M3 SP4
		Microsoft Windows Server 2003 Datacenter 64-bit Edition	9.1 TS1M3 SP4
		z/OS	9.1 TS1M3 SP4
		Microsoft® Windows® for 64-Bit Itanium-based Systems	9.1 TS1M3 SP4
		Microsoft Windows XP 64-bit Edition	9.1 TS1M3 SP4
		Microsoft® Windows® for x64	9.1 TS1M3 SP4
		Microsoft Windows 2000 Advanced Server	9.1 TS1M3 SP4
		Microsoft Windows 2000 Datacenter Server	9.1 TS1M3 SP4
		Microsoft Windows 2000 Server	9.1 TS1M3 SP4
		Microsoft Windows 2000 Professional	9.1 TS1M3 SP4
		Microsoft Windows NT Workstation	9.1 TS1M3 SP4
		Microsoft Windows Server 2003 Datacenter Edition	9.1 TS1M3 SP4
		Microsoft Windows Server 2003 Enterprise Edition	9.1 TS1M3 SP4
		Microsoft Windows Server 2003 Standard Edition	9.1 TS1M3 SP4
		Microsoft Windows XP Professional	9.1 TS1M3 SP4
		Windows Vista	9.1 TS1M3 SP4
		64-bit Enabled AIX	9.1 TS1M3 SP4
		64-bit Enabled HP-UX	9.1 TS1M3 SP4
		64-bit Enabled Solaris	9.1 TS1M3 SP4
		HP-UX IPF	9.1 TS1M3 SP4
		Linux	9.1 TS1M3 SP4
		Linux on Itanium	9.1 TS1M3 SP4
		Solaris for x64	9.1 TS1M3 SP4

* For software releases that are not yet generally available, the Fixed Release is the software release in which the problem is planned to be fixed.

---

If downloading to a Windows machine, select this file:

fusion_34919_1_omabakup913Encoding.ZIP

If downloading to a Unix machine, use this file:

fusion_34919_2_omabakup913Encoding.tar

This version of %OMABAKUP allows you to back up a metadata server using a non-standard session encoding setting that would result in transcoding errors if using the original %OMABAKUP macro.

Type:	Usage Note
Priority:
Topic:	System Administration ==> Servers ==> Metadata

Date Modified:	2009-03-16 14:26:53
Date Created:	2009-02-23 15:16:22