Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ (1) — SNA TN3270-C 1.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

stop3287(1)

tn3270c(1)

tn3287(4)



tn3287c(1)               USER COMMANDS                 tn3287c(1)



NAME
     tn3287c - start tn3287 printer emulator

SYNOPSIS
     tn3287c [PeName] [-h Host] [-p Port]
     [-dn DeviceName] [-3270Name Name]
     [ -n Number] [ -nf ] [ -nl ] [ -d Directory]
     [ -C PipeDirectory]

DESCRIPTION
     Starts the  tn3287  printer  emulator  included  in  EXPRESS
     TN3270-C.  The  configuration  of tn3287 printer emulator is
     determined using one or more of the following methods:

     o  tn3287c command line options. Unless otherwise  indicated
        below,  all  options  can also be specified in the tn3287
        printer emulator configuration file.

     o  tn3287 printer emulator configuration files. For informa-
        tion on the configuration file syntax, see tn3287c(4).

     o  Internal  program  defaults.  These  default  values  are
        specified  in  the  options below and in the keyword list
        for tn3287c(4).

     To stop the tn3287 printer emulator, use stop3287(1).

OPTIONS
     PeName
          Directs tn3287c to create a  printer  emulator  session
          using  the  configuration defined by the tn3287 printer
          emulator configuration file with  the  name  PeName.pc.
          The  combination of PeName, user ID, and pipe directory
          must be unique for every instance  of  tn3287c  running
          concurrently.  There is no default PeName. If PeName is
          not specified, tn3287c builds a configuration based  on
          the  command line options and internal program defaults
          as described in tn3287c(4). If PeName is specified  but
          the  file  does  not exist, tn3287c exits with an error
          message.

     -h Host
          Specifies the host name (from the /etc/hosts  file)  or
          IP  address  for the tn3270 server used with the tn3287
          printer emulator session.  This  option  overrides  the
          value  for  IPHostName  specified in the tn3287 printer
          emulator configuration file. There is no  default  host
          name, but a value is required.

     -p Port
          Specifies the TCP/IP service name or port  number  used
          for  the  tn3270  service.  If  Port  is  all  numeric,



                      Last change: 4/13/95                      1





tn3287c(1)               USER COMMANDS                 tn3287c(1)



          tn3287c(1) assumes a port address.  This  option  over-
          rides  the  value  for  IPServiceName  specified in the
          tn3287 printer emulator configuration file. The default
          IP  service  name is tn3270.  If tn3270 is not defined,
          the default is telnet.

     -dn DeviceName
          Specifies the name of the device,  a  specific  logical
          unit  (LU)  or  LU  pool, to which you wish to connect.
          This option overrides the value for  DeviceName  speci-
          fied in the tn3287 printer emulator configuration file.
          DeviceName is a string whose length is entirely  deter-
          mined  by  your specific tn server. There is no default
          device name.

     -3270Name Name
          3270Name is similiar to -dn, but while -dn specifies an
          LU  or  LU  pool  for  connection,  3270Name indirectly
          determines the LU  or  LU  pool  used  for  connection.
          3270Name  specifies  the name of the LU or LU pool that
          was assigned previously to a 3270 terminal session  and
          causes tn3287c(1) to issue a tn3270E ASSOCIATE command.
          Unlike the CONNECT command caused by -dn, the ASSOCIATE
          command requests that the tn server assign the LU or LU
          pool for the printer device that  is  paired  with  the
          3270  terminal  session  to the tn3287 printer emulator
          session. 3270Name indicates the name of the  LU  or  LU
          pool  for  3270  terminal  session  in the terminal and
          printer device pair. Name is a string whose  length  is
          entirely  determined  by your specific tn server. There
          is no default.

     -n Number
          Specifies the  maximum  length  (in  characters)  of  a
          printed  line.  The  default  value is 132. This option
          cannot be set using the tn3287 printer emulator  confi-
          guration file.

     -nf  Specifies that only formfeeds explicitly  generated  by
          the  host  appear in the output, overriding the default
          to generate automatic formfeeds. This option cannot  be
          set  using  the  tn3287  printer emulator configuration
          file.

     -nl  Specifies that only linefeeds explicitly  generated  by
          the  host  appear in the output, overriding the default
          to generate automatic linefeeds. This option cannot  be
          set  using  the  tn3287  printer emulator configuration
          file.

     -d Directory
          Specifies the  directory  containing  EXPRESS  TN3270-C



                      Last change: 4/13/95                      2





tn3287c(1)               USER COMMANDS                 tn3287c(1)



          (This option is only needed if you have rearranged your
          EXPRESS TN3270-C directory  structure  after  installa-
          tion).  The  default is $COMMLINK/bin/3270. This option
          cannot be set using the tn3287 printer emulator  confi-
          guration file.

     -C PipeDirectory
          Specifies the directory containing  shared  memory  key
          pipes  (This  option  is  only needed if you have rear-
          ranged your TN3270-C directory structure after  instal-
          lation).
          The default is $HOME/Express/3270/pipes/$LOGNAME.
          If this  directory  does  not  exist,  the  default  is
          $COMMLINK/pipes/$LOGNAME.   This  option  cannot be set
          using configuration files.


FILES
     $COMMLINK/adm/3270/tn3287-c.pc  Sample tn3287 printer emula-
                                     tor configuration file


SEE ALSO
     stop3287(1), tn3270c(1), tn3287(4), EXPRESS TN3270-C  User's
     Guide






























                      Last change: 4/13/95                      3



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026