The following procedure explains how to download software from the Precisely Data Experience (PDX).
- On the PDX portal, navigate to My Software Products
- From My Software Products, download your active software subscriptions.Tip: You must be signed in to the PDX portal to access My Software Products.
When you purchase Software from Precisely, the Fulfillment team "provisions" the primary contact user or users to enable download from the PDX and sends an email with instructions for creating a password to access the site.
You can choose to download the purchased software by selecting any of the supported Data formats relevant to the Software. Users typically receive an email from Precisely when new Software releases are available for download. Provisioned users can also typically access previously downloaded versions of Software at the PDX.
If the software download link is not accessible through this portal, you may reach out to Customer Support for additional assistance.
License Key
Companies performing a product evaluation need to request license keys from Customer Support to activate the SCC products.
Software
When downloaded from the PDX website, the distribution libraries have been compressed into a self-extracting ZIP file (.exe) which can be expanded on a PC.
.exe downloads through a web browser, two other distributions are provided.The .zip file contains the same files as the self-extracting .exe file, while the _distronly.zip file omits all .exe and .bat files from the download.
Once the product installation files are available on a PC, the product distribution files can then be uploaded to your host system. To continue with the installation process, refer to Transferring PC distribution files to your host below.
Documentation
All the SyncsortTM Storage Management Software documentation is available at the Precisely Help Center. The product guides can be downloaded in PDF format from the Precisely Help Center using Print this topic option.
To access all site capabilities, click at the top-right corner of the Precisely Help Center, and use your Precisely Customer or Partner Community sign-in credentials.
If you do not have a Community account, register at https://rc.precisely.com/customer-self-registration-portal.
Service level and product release information
When a new set of distribution libraries is created, the build process assigns the current Julian date as the software's Service Level. The third level qualifier on the distribution libraries identifies the service level. For example, the following data set is at service level 21054.
DTS.R71.SL21054.LOADLIB
After installation on your mainframe system, the service level and product release
information for each product can be found in
DTS.R71.SLyyddd.LOADLIB(DTSRELI).
Electronic delivery of distribution data sets
XMIT
TSO Command processor. This allows the distribution libraries to be sent to other z/OS systems. The following "unloaded" distribution files are transmitted to the host:LOADLIB.XMI unloaded version of DTS.R71.SLyyddd.LOADLIB
INSTLIB.XMI unloaded version of DTS.R71.SLyyddd.INSTLIB
ISPFLIB.XMI unloaded version of DTS.R71.SLyyddd.ISPFLIB
SAMPLIB.XMI unloaded version of DTS.R71.SLyyddd.SAMPLIB
RPTLIB.XMI unloaded version of DTS.R71.SLyyddd.RPTLIB During the install process, a batch job will allocate the "real" distribution libraries,
and use the TMP to RECEIVE the "unloaded" files and populate the real
distribution files. The install process will delete the "unloaded" versions of the
distribution files. After the batch job completes, the following SCC
distribution data sets can be found on the volume you selected:
DTS.R71.SLyyddd.LOADLIB
DTS.R71.SLyyddd.INSTLIB
DTS.R71.SLyyddd.ISPFLIB
DTS.R71.SLyyddd.SAMPLIB
DTS.R71.SLyyddd.RPTLIB
Distribution data sets
The following list shows sample distribution libraries and the storage attributes. These are the data sets that should exist on your host system after completing the software installation covered in this chapter.
DTS.R71.SLyyddd.LOADLIB
The load library for all products.
BLKSIZE:6144 RECFM:U
SPACE: CYL(5,2,80)
DTS.R71.SLyyddd.INSTLIB
This file contains the installation library. This library contains installation JCL and the parameter information intended for the DIF parameter library:
DTS.R71.PARMLIB
BLKSIZE:3120 LRECL:80 RECFM:FB
SPACE: CYL(1,1,40)
DTS.R71.SLyyddd.ISPFLIB
This file contains the ISPF members used for the products.
BLKSIZE:3120 LRECL:80 RECFM:FB
SPACE: CYL(10,2,80)
DTS.R71.SLyyddd.SAMPLIB
BLKSIZE:3120 LRECL:80 RECFM:FB
SPACE: CYL(5,2,80) DTS.R71.SLyyddd.RPTLIB
This file contains the report library used for creating reports for the products.
BLKSIZE:3120 LRECL:80 RECFM:FB
SPACE: CYL(5,2,80)
Transferring PC distribution files to your host
This section documents the methods of moving the distribution libraries from your PC to your host. To use the distribution facilities documented in this section, you must have:
- a personal computer with access to your host system
- the ability to file transfer text and binary files to your host system.
There are two methods of installation:
- If you can FTP files from your PC to the host, the
FTPINSTW.EXEandFTPINST.BATcommands provide the quickest installation procedure. - Otherwise, you can use the file transfer facility in your TN 3270 Emulation client.
Note: The following installation procedure assumes you already received the self-extracting file via the Internet or email, and the file has been expanded in an empty directory. - If you can FTP files from your PC to the host, the
Installation via FTPINSTW.EXE
If your host environment runs an FTP Server, the FTP Installation application (FTPINSTW.EXE) can be used to create the distribution libraries on your z/OS system.
FTP Installation Application
This 32-bit Windows application automatically allocates and transfers the "unloaded" distribution libraries to your host. The program then builds and submits a job to:
- allocate the "real" distribution libraries
- run the
TMPto RECEIVE the unloaded files into the distribution libraries - delete the "unloaded" distribution files
The FTP Installation application can only be run on a modern Windows-based system. As an alternative, see the
FTPINST.BATinstallation procedure documented in the next section. To activate the installation program, examine the directory containingFTPINSTW.EXE, and double-click on the file.Note: TheFTPINSTW.EXEprogram must reside with the other distribution files.
The FTP Installation application provides an easy install interface for the user. The single form requires:
- IP address or domain name of your z/OS FTP Server
- Userid/Password
- job card statement(s)
- HLQ and a Volume or Storage Class for the distribution data sets
If you don't know the IP address of your FTP Server, try browsing
SYS1.PROCLIB(TCPIP).
HOME
199.72.47.195 ETH1
A TSO Userid, Password, and JOB
card are required for the FTP install process. Symbolic substitution will
be performed on any %userid% and %password% variables
in the job card. Also, USER= and PASSWORD= parameters
are required on the job card, and you might also want to route the output to a held
printer queue.
You only have to enter the information the first time you use the application. The
installation program saves the user input for subsequent calls in two files:
FTPINSTW.INI and FTPINST.JOB. An installation FTP
log is also created in FTPINSTW.LOG. These files are saved in the user
application directory - usually
c:\Users\username\AppData\Roaming\DTS or
c:\Users\username\AppData\Local\DTS.
FTPINSTW.EXE application to install the
same SCC service level, the host libraries will be refreshed by the
procedure.Installation via FTPINST.BAT
If your host runs an FTP Server and your PC denies access to the
FTPINSTW application, the FTPINST.BAT file can be
used to install the SCC distribution libraries.
FTPINST builds an FTP script to create the "unloaded" distribution
libraries on the host system. The batch file then builds and submits a job via FTP to
allocate the distribution libraries and RECEIVE the unloaded files.
Before running the FTPINST batch file, you must modify the
JOBCARD.TXT member so it contains a valid job card for your
installation. The USER= and PASSWORD= parameters are
required, and you might also want to route the output to a held printer queue.
JOBCARD.TXT. Also, when
installing from the CD, the job card information must be created on your hard-drive, and
you must use a fully qualified member name in the last FTPINST
parameter.The sample JOBCARD.TXT file:
//jobname JOB REGION=1M,USER=userid,PASSWORD=password
/*ROUTE PRINT FETCH
After modifying the jobcard.txt file, you can issue the
FTPINST command. Open a DOS session and default to the directory
containing the distribution files. From the DOS prompt issue the
FTPINST command. Since most of the parameters are used in JCL
submitted to your host, you must code the parameters in upper-case.
The FTPINST batch file has six positional parameters:
- HLQ of the distribution libraries. Note: This parameter can contain multiple qualifiers (i.e.
VENDOR.DTS). Also, this parameter is case dependent and should be entered in uppercase. - IP address or Domain name of the z/OS FTP Server
- TSO Userid for logon
- TSO Password for logon
- The volume name for new allocations. Note: This parameter is case dependent and should be entered in uppercase.
- Name and location of the file containing the JOB card information (i.e.
c:\temp\jobcard.txt).
Sample execution:
ftpinst DTS 199.72.47.195 USER1 PASS1 DTS001 JOBCARD.TXT
After using the FTPINST installation method, you can further automate
the procedure by building another batch file that executes the FTPINST
command with your installation parameters. For example, you could create an
INST.BAT member that executes the command above. When you download
another SCC Service Level, expand the .exe file in
the same directory as the INST.BAT and JOBCARD.TXT
files, but don't overwrite your job card file. The next installation can then be done by
simply issuing INST.
FTPINST command on the same
SCC service level, the host libraries will be refreshed by the
procedure.Installation via 3270 emulation
This installation method uses the 3270 emulation file transfer facilities to build the
installation libraries on your host. Please examine the README.TXT file
for detailed instructions on the process required for the
product. The following steps are generalized instructions for
electronic delivery.
-
STEP 1: Start your 3270 emulation software on your PC. LOGON
to your host system. Note: Stay in READY mode - do not enter ISPF.
- STEP 2: Use your 3270 emulation software to file transfer the ALLOCATE and RECEIVE files to your host system. Since the members contain character data, send the members as text files - use the ASCII and CRLF options on the file transfer and Record Format = Default. A sample SEND command follows: SEND ALLOCATE 'userid.ALLOCATE' ASCII CRLF SEND RECEIVE 'userid.RECEIVE' ASCII CRLF
-
STEP 3: Go to your TSO session and edit
'userid.ALLOCATE'. Use the JCL to pre-allocate the data sets required for installation. Add an appropriate job card, select a volume for the data sets, and submit the JCL to allocate the data sets. -
STEP 4: Use your 3270 emulation software to file transfer the
unloaded distribution files to your host system. The files require a
binary file transfer. A sample SEND command for the
SCC distribution load library follows. The
README.TXTfile will contain the list of distribution libraries to transfer to your host system.SEND LOADLIB.XMI 'DTS.R71.LOADLIB.XMI' -
STEP 5: Edit
'userid.RECEIVE'. The JCL executes TSO in a batch environment. This job uses RECEIVE commands to reload the distribution libraries created by the ALLOCATE job. Add an appropriate job card, modify the data set names to those used in Step 3, and submit the job.Note: The RECEIVE job will always get a return code of zero. Please examine the job output to ensure that the data sets were loaded correctly. If the RECEIVE commands did not work correctly, you may want to examine the file transfer options in your 3270 emulation software and retry step 4. Using "screen buffered" transfers instead of "structured fields" often solves file transfer problems on binary files.Warning: If the target libraries already contain members, the IEBCOPY performed by the RECEIVE will replace existing members. -
STEP 6: The distribution libraries have now been loaded on
your host system. You can now delete the "unloaded" distribution libraries. The
README.TXTfile will contain the list of "unloaded" distribution libraries that can be deleted.