Customize the STC Procedure

topofpage
cszscss
The SMP/E install creates a sample STC procedure to start the CA LDAP Server. The procedure is installed with the minimum of configuration options. The procedure has the following line:
// PARM='PGM slapd -d 0 -f ./slapd.conf -d &DEBUG'
This line configures the CA LDAP Server to start with no debugging and to use the configuration file slapd.conf.
When running as a started task, -d 0 is required as a minimum.
Parameters are case sensitive. When adding any startup options, use the proper case.
PARM= Options
The following list details PARM options:
  • -d
    nnn
    Configures the debugging trace level of the CA LDAP Server. The CA LDAP Server uses this value to determine what to write to the STDERR DD. The
    nnn
    value can be a numeric or text value (0 through 4294967295).
    Default
    : 0
    To review this table of values, search under the global option debug in this documentation.
  • -f
    file_name
    Configures the startup configuration file. This option can use either a relative or fully qualified file name.
    Default
    : n/a
  • -H
    url
    :
    port
    Configures the URL (IP and port) that the CA LDAP Server uses to listen for LDAP requests. An single IP address is not specified. This configuration ensures that if multiple TCP/IP stacks are running on the LPAR, the LDAP Server listens on port 389 on all IP addresses. Because the PARM= option is limited to 100 bytes, we recommend that you supply the URLs in the slapd.conf file. For more information, review the slapd.conf hosturls global option in this documentation.
    Default
    : ldap://:389
  • -l
    LOCALx
    (This command line option is a lowercase L) Configures which syslog facility to write to. This option is used with the -s option. Valid values are as follows: LOCAL0, LOCAL1, LOCAL2, LOCAL3, LOCAL4, LOCAL5, LOCAL6, or LOCAL7.
    Default
    : LOCAL4.
  • -s
    nnn
    Configures the syslog trace level of the CA LDAP Server. The CA LDAP Server uses this value to determine what to write to the syslog daemon. The
    nnn
    value can be a numeric or text value.
    Default
    : 0
    To review this table of values, search under the global option loglevel in this documentation.
  • -T
    Enables a low-level memory usage trace that is written to the STDERR DD. This value produces a large amount of tracing and reduces the performance of the CA LDAP Server.
    Do not enable this value unless CA Support requests that you do so.
  • -N
    Configures the CA LDAP Server to start in non-swap mode, which makes the CA LDAP Server non-swappable and all memory that it allocates is also non-swappable. The STC ID that is used to start the CA LDAP Server requires at least READ access to BPX.STOR.SWAP to invoke this option.
    When an application makes an address space non-swappable, it might cause additional real storage in the system to be converted to preferred storage. Because preferred storage cannot be configured offline, using this service can reduce your ability to reconfigure storage in the future.
STDENV DD
The STC procedure to start the CA LDAP Server also has an STDENV DD. The DD points to an HFS file that contains environment variables that the CA LDAP Server needs.
When you change this file, do not use quotes around the values. The quotes are taken as part of the actual value and passed to the UNIX shell.