Your browser does not allow this site to store cookies and other data. Some functionality on this site may not work without them. See Privacy Policy for details on how we would use cookies.

SSH Tectia 
PreviousNextUp[Contents] [Index]

    About This Document >>
    Installing SSH Tectia Server for IBM z/OS >>
    Using SSH Tectia Server for IBM z/OS >>
        Running the Server >>
        Setting Up a Shell User>>
        Running Client Programs>>
        Handling MVS Datasets and HFS File System Access>>
            Dataset and HFS File System Access
            Dataset Access Using DD Cards
            Controlling the File Transfer
            Staging
        Listing Datasets with SFTP Clients>>
    Configuring the Server >>
    Configuring the Client >>
    Authentication >>
    Troubleshooting SSH Tectia Server for IBM z/OS >>
    Examples of Use >>
    Man Pages >>
    Log Messages >>

Staging

The current Secure Shell protocol, as implemented in third-party products and current SSH Tectia versions, is designed for Unix files which are byte streams. MVS datasets are record-based. They must be staged before sending or destaged after they have been received. Staging copies a dataset into byte stream format and may also convert the character set. Destaging transforms a byte stream into a file format and may also convert the character set. Only HFS files that do not need character set conversion do not need to be staged.

Offline staging stores the byte stream as an HFS file. Online staging places the byte stream in virtual storage when the file is transferred. SSH Tectia Server for IBM z/OS includes a utility program, ssh-sft-stage, for offline staging and destaging. STAGE is a sample of JCL for running the staging utility located in SAMPLIB (shown below).

STAGE:

//STAGE   EXEC PGM=IKJEFT01,
//             DYNAMNBR=75,
//             TIME=100,
//             REGION=6M
//SYSPRINT DD  SYSOUT=*
//SYSTSPRT DD  SYSOUT=*
//SYSTERM  DD  DUMMY
//SYSUADS  DD  DSN=SYS1.UADS,DISP=SHR
//SYSLBC   DD  DSN=SYS1.BRODCAST,DISP=SHR
//STDOUT   DD  PATH='/home/&SYSUID./stage_stdout',
//             PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//             PATHMODE=SIRWXU
//STDERR   DD  PATH='/home/&SYSUID./stage_stderr',
//             PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//             PATHMODE=SIRWXU
//STDENV   DD  DSN=&SYSUID..SSZ.SAMPLIB(SSHENV),
//             DISP=SHR
//PROGLI   DD  DSN=&SYSUID..TEST.C.LIST,
//             DISP=SHR
//SYSTSIN  DD  *
  BPXBATSL PGM /usr/lpp/ssh2/sbin/ssh-sft-stage +
               -v +
               -i /FTADV:F=LINE,D=IBM-1047,C=ISO8859-1/+
                  //DD:PROGLI +
               -s /tmp/stage.tmp
   ALLOCATE FILE(PROUT1) DA(*) LRECL(252) RECFM(V,B) REUSE
  ALLOCATE FILE(PRERR1) DA(*) LRECL(252) RECFM(V,B) REUSE
  OCOPY INDD(STDOUT) OUTDD(PROUT1) TEXT PATHOPTS(OVERRIDE)
  OCOPY INDD(STDERR) OUTDD(PRERR1) TEXT PATHOPTS(OVERRIDE)
/*                      

The SSH Tectia Server for IBM z/OS server program will use online staging automatically if a dataset cannot be transferred directly. Online staging is more convenient and, for small files, more efficient.

Offline staging incurs the overhead of writing the byte stream to disk and reading it. Online staging, for large files, will page out most of the byte stream and will page it in again. Online staging does not support files that are larger than 2 GB.

The SSH Tectia Server for IBM z/OS client programs support native MVS dataset reading and writing and do not require staging. Offline staging is still needed if a file is transferred to an MVS server and the size of the file is larger than 2 GB. To use offline staging, you must run the ssh-sft-stage utility as a separate step.

A summary of situations when staging is needed is shown in the table below. In the table, Native indicates that staging is not required, Online indicates that online staging is automatically used, and Offline indicates that the dataset has to staged offline.

Client versionServer versionFile size <2GBFile size >2GB
SSH Tectia Unix/Win 5.2- SSH Tectia z/OS 5.2- Native Native
SSH Tectia z/OS 5.2- SSH Tectia Unix/Win 5.2- Native Native
SSH Tectia z/OS 5.2- SSH Tectia z/OS 5.2- Online Offline
SSH Tectia z/OS 5.2- SSH Tectia (all) 4.x-5.1 Online Offline
SSH Tectia (all) 4.x-5.1 SSH Tectia z/OS 5.2- Online Offline

PreviousNextUp[Contents] [Index]


[ Contact Information | Support | Feedback | SSH Home Page | SSH Products ]

Copyright © 2006 SSH Communications Security Corp.
This software is protected by international copyright laws. All rights reserved.
Copyright Notice

===AUTO_SCHEMA_MARKUP===