Previous Topic

Next Topic

Book Contents

Book Index
Report distribution setup in Control-D for z/OS
  1. Set the following parameters in the CTDSPARM member in the CTD PARM library:

    Parameter

    Description

    HOST

    Host name or IP address of Control- D for DS Distribution Server. ",C" after the host name or value indicates that data compression is required during report transfer. The compression option is available in Control‑D/Delivery Server version 3.5.xx and later.

    PORT

    Default port number for session manager in Control-D/Delivery Server.

    MAIL_HOST SMTP

    Host name to be used by the Distribution Server for sending e-mail messages

    DSR_NAME DS

    Repository name as it appears in Control- D/Desktop (for example, "Repository NT -TLV475")

    MFR_NAME MF

    Repository name as it appears in the "External Repositories" section in Control-D/Desktop (for example, IOAR610)

    USER_NAME POD

    User name to be used for Resource retrieval

    PASSWORD

    Password for the above POD User

    The MFR_NAME, USER_NAME, and PASSWORD parameters are used for Resource retrieval from the MF Repository when the report is processed in Control- D by ON TRNCLASS (or ON TRNDSN) decollation and it is transformed into PDF or HTML format in Control-D/Delivery Server. Note also that the user specified in the USER_NAME field requires authorization for POD, but does not require authorization to access reports.

  2. Customize external destinations in Control-D if required. The Control-D installation contains a predefined set of destinations for report distribution as specified below:

    Parameter

    Description

    FTB2P

    For sending AFP/XEROX reports to File Transfer with transformation to PDF

    FTPDF

    For sending PDF reports to File Transfer

    FTTXT

    For sending text report to File Transfer

    FTT2P

    For sending AFP/XEROX reports to Local File System with transformation to PDF

    LFSB2P

    For sending AFP/XEROX reports to Local File System with transformation to PDF

    LFSPDF

    For sending PDF reports to Local File System

    LFSTXT

    For sending text report to Local File System

    LFST2P

    For sending text reports to Local File System with transformation to PDF

    LPRB2P

    For sending AFP/XEROX reports to printer

    LPRPDF

    For sending PDF reports to printer

    LPRTXT

    For sending text report to printer

    MAILB2P

    For sending AFP/XEROX reports by e-mail with transformation to PDF

    MAILPDF

    For sending PDF reports by e-mail

    MAILTATT

    For sending text reports by e-mail as attachment

    MAILTXT

    For sending text report by e-mail (body)

    MAILT2P

    For sending text reports by e-mail with transformation to PDF

    These destinations contain variables, which are substituted during the report transfer process.

    The %FOLDER%, %EMAIL%, %FAX%, and %PDF-USER-PASS% variables are substituted according to the Description field in the Recipient Tree, where they can be defined as DESC FOLDER=xxx.

    For Deferred printing of Subscribed reports and Deferred Printing by Index these variables are substituted according to the subscription records from the Permanent User File (if they exist) – see INCONTROL for z/OS Utilities Guide; Control-D and Control-V Utilities; CTVUPINV – Global update of subscription records in the Permanent User File.

    The %REPORT%, %REMARK%, %REMARK2%, %REMARK3%, %JOBNAME%, %ODATE%, %RECIPIENT%, %REPORTID%, %JOBID%, %CLASS%, %EXTWTR%, %FORM%, %DEST%, %RECFM%, %CRDATE%, %JOBSTART%, %JOBEND%, %DDNAME%, %PGMSTEP%, %PROCSTEP%, %EXPDATE%, %TIMESTAMP% (TIMESTAMP of creating CTDS data sets) and %TYPE% variables are substituted according to the attributes of the report being distributed.

    The variables %INDEXN% (last level INDEX name), %INDEXV% (last level INDEX value), %INDEXNP% (INDEX name path) and %INDEXVP% (INDEX value path) are substituted during Deferred printing by index.

    In most cases, the predefined External Destinations can be used 'as is'. If required, they can be customized through IOA Online (see Control-D/Delivery Server in the Control-D and Control-V User Guide).

  3. Set the following additional parameters in CTDSPARM member used for subscription:

    Parameter

    Description

    NOTIFICATION

    Specifies the default external CTDS destination. Used for distributing e-mails with notification of subscribed reports. The destination must be available in the Control-D repository. Mandatory if the customer wants to use subscription for sending notification about the reports (indexes) created in the Control-D repository to end-users.

    E_MAIL

    Specifies the default external CTDS destination. Used for distributing subscribed reports by e-mails. The destination must be available in the Control-D repository. Mandatory if a customer wants to use subscription for sending reports (indexes) to end-users.

    E_MAIL_TXT

    Specifies a separate external CTDS destination for distribution by e-mail of subscribed reports in text format. The destination for text reports must be available in the Control-D repository.

    E_MAIL_PDF

    Specifies a separate external CTDS destination for distribution by e-mail of subscribed reports in PDF format. The destination for PDF reports must be available in the Control-D repository.

    E_MAIL_BINARY

    Specifies a separate external CTDS destination for distribution by e-mail of subscribed reports in binary format. The destination for binary-format reports must be available in the Control-D repository.

    HOST_PRINT

    Specifies the default local or remote JES printer destination (node and user ID). One or two sub-fields can be specified. If it consists of two sub-fields, they must be enclosed in brackets. Used for printing subscribed reports to SPOOL. Optional.

    PRINT_NOTIFY

    Specifies the name of the default print mission for processing subscribed reports.

Parent Topic

User Requirements