ML07-0001-0

Index

/.dm
HTTPDM, a dump of storage
/.dmtt
HTTPDMTT, the Master Trace Table; Reading the Master Trace Table
/.dsrv
HTTPDSRV, the control blocks
/login
The Fixed Paths; FORM
/logout
The Fixed Paths; FORM
/zosmf
The Standard Module: mvsMF
3.x
Upgrading from HTTPD 3.x
302
302, the Login Form
4.0.x
Upgrading from HTTPD 4.0.x
401
How a Request Is Checked; 401, the Route Needs a Login
403
How a Request Is Checked; RES=: Checking a Profile; 403, the Resource Is Denied
403, no profile
Refusing a Route Whose Profile Is Missing
404
A File That Is Not There; 404, There Is No File
405
405 and 501, the Method
405 Method Not Allowed
What Is Not Supported
501
405 and 501, the Method
501 Not Implemented
What Is Not Supported
503
A Route to a Missing Module; A Module Does Not Run
__wsaget
Storage
abend, module
When a Module Abends
abend, worker
Worker Abends
ACEE
The Identity of the Server
allocation
Allocating the Product Data Sets
APF
Authority
APF, troubleshooting
Authorization Fails
APF authorization
Where the Module Must Be
argv, module
The Entry Point
AUTH=
AUTH=: What a Route Asks For
AUTH=, wrong value
A Route Without a Valid Policy
AUTH=BASIC
AUTH=: What a Route Asks For
AUTH=FORM
AUTH=: What a Route Asks For
AUTH=NONE
AUTH=: What a Route Asks For
AUTH=TOKEN
AUTH=: What a Route Asks For
authentication
Authentication and Security
authentication, two stages
How a Request Is Checked
authorization
Authority
Basic authentication
BASIC
bearer token
TOKEN
BIND_TRIES
The Port Is Busy
C HTTPD
Cancelling
cancel
Cancelling
CGI=
Retired Keywords
CGI_CONTEXT_POINTERS
Context Blocks for Modules
cgistart
The Entry Point
chapters, overview
Which Chapter for Which Task
client
Choosing a Client
CLIENT_STATS
The Diagnostic of a Client Time-out
CLIENT_TIMEOUT
Keep-Alive and Client Time Limits
CLIENT_TIMEOUT_DUMP
The Diagnostic of a Client Time-out
CLIENT_TIMEOUT_MSG
The Diagnostic of a Client Time-out
code page
The Code Page
code page, static files
Text, Binary and the Code Page
CODEPAGE
The Code Page; Text, Binary and the Code Page
comment
The Format of the Member
configuration
Configuring HTTPD
configuration, errors
What a Bad Line or a Bad Value Does
connection refused
The Client Cannot Connect
console, login messages
Console Messages for Logins
console commands
The Operator Commands
Content-Type
Content Types
context block
Context Blocks for Modules
CP037
The Code Page
credential cache
How Long a Login Lasts; A Changed RACF Password and the Cached Login; A Changed Password Does Not Take Effect
curl
Choosing a Client
curl, testing a module
Testing with curl
D CONFIG
Reading Back What HTTPD Parsed
D PORTS
Changing the Port
D TIME
The Time Zone
D, procedure symbol
Which Member HTTPD Reads
DD:HTTPPRM
Which Member HTTPD Reads
DEBUG
The Trace
default.html
Directory Requests
DEL SYSMOD
Step 2: Cut the FMIDs out of the SMP Inventory
deploy, server module
Deploying and Routing
development build
A Development Build with a Later FMID
directory request
Directory Requests
DISPLAY CONFIG
The configuration, the port, the version and the time
DISPLAY LOGIN
Who is logged in
DISPLAY MEMORY
Storage
display modules
The Display Modules over HTTP
display modules, authentication
What authentication they need
DISPLAY STATS
The statistics
DISPLAY THREADS
The threads
DOCROOT
The Document Root; Where the Files Are
DOCROOT, changing
Changing the Document Root
document root
The Document Root Disk; The Document Root; Where the Files Are
ESTAE
Worker Abends; When a Module Abends
exempt paths
What Needs No Login
extension route
MOD= Routes
FACILITY class
RES=: Checking a Profile
file extension
Content Types
first match
The Order of the Routes and the First Match
first request
A First Request
FMID
One Release at a Time
form login
FORM
FTP
Sending the Two XMIT Files
HEAD
What Is Not Supported; 405 and 501, the Method
header terminator
A Response Takes Five Seconds
HELLO, example module
The Smallest Complete Module
HELP command
Help
history
Version and Lineage
http_cgictx_get
Context Blocks for Modules
http_new_session
HTTPD Levels and the Function Vector
http_printf
Sending the Response
http_resp
Sending the Response
HTTPD, level
HTTPD Levels and the Function Vector
HTTPD, limits
What HTTPD Does
HTTPD, overview
Introducing HTTPD
HTTPD, purpose
What HTTPD Does
HTTPD.AHTTPLOD, removal
Step 4: Scratch the Libraries
HTTPD.LINKLIB, removal
Step 4: Scratch the Libraries
HTTPD.WEBROOT.UFS
Building a Web Root Image
HTTPD001I
What the Console Shows
HTTPD002I
Authorization Fails
HTTPD003W
The Server Has Not Its Own Identity
HTTPD004I
The Identity of the Server
HTTPD004W
The Identity of the Server; The Server Has Not Its Own Identity
HTTPD007I
Console Messages for Logins
HTTPD008I
Console Messages for Logins
HTTPD008W
Console Messages for Logins
HTTPD009W
Console Messages for Logins
HTTPD012E
Authorization Fails
HTTPD014E
The Procedure Has the Wrong DD Names
HTTPD020W
A missing Parmlib member is not a refusal; The Member Is Not There
HTTPD025I
The Time Zone
HTTPD026E
Sessions and the Client Time Limit; Sessions That Are Too Short
HTTPD026W
What a Bad Line or a Bad Value Does; A Line Without an Equals Sign; Lines the Server Skips
HTTPD029W
What a Bad Line or a Bad Value Does; An Unknown Keyword; Lines the Server Skips
HTTPD030E
The Port Is Busy
HTTPD030I
The Port Is Busy
HTTPD032E
Sessions and the Client Time Limit; Sessions That Are Too Short
HTTPD037E
A start that is refused; The Port Is Busy
HTTPD042W
A Security System That Accepts Any User ID; Console Messages for Logins; Every Login Is Refused, HTTPD042W
HTTPD044W
When UFSD Is Not There; Static Files Are Not Served
HTTPD048E
A Route Without a Valid Policy
HTTPD054I
Changing the Port
HTTPD062E
Worker Abends; Requests Wait or Workers Abend
HTTPD063E
Requests Wait or Workers Abend
HTTPD065W
The Client Cannot Connect
HTTPD066I
The Request Trace
HTTPD067W
The Request Trace
HTTPD070E
The Code Page
HTTPD098I
A Start That Ends
HTTPD099I
A Start That Ends
HTTPD101E
Commands that are not accepted
HTTPD128I
Reading Back What HTTPD Parsed
HTTPD132I
Recording SMF Records
HTTPD133I
Reading Back What HTTPD Parsed
HTTPD138I
Refusing a Route Whose Profile Is Missing
HTTPD411E
A Route Without a Valid Policy
HTTPD412W
Warnings and Refusals While HTTPD Reads the Routes
HTTPD413W
Warnings and Refusals While HTTPD Reads the Routes
HTTPD414W
Warnings and Refusals While HTTPD Reads the Routes
HTTPD419E
A Route Without a Valid Policy
HTTPD420E
Refusals; A Route Without a Valid Policy
HTTPD424W
The Realm
HTTPD425W
Warnings and Refusals While HTTPD Reads the Routes; RES=: Checking a Profile
HTTPD426W
Refusing a Route Whose Profile Is Missing
HTTPD427E
Refusing a Route Whose Profile Is Missing; A Route Without a Valid Policy
HTTPD430W
Recording SMF Records
HTTPD440W
Modules Held in Storage: RESIDENT
HTTPD441W
Modules Held in Storage: RESIDENT
HTTPD442W
Modules Held in Storage: RESIDENT
HTTPD444W
The Request Trace
HTTPD908E
A Route to a Missing Module; Worker Abends; When a Module Abends; A Module Does Not Run
HTTPDBG
The Trace
HTTPDM
The Display Modules over HTTP
HTTPDMTT
The Display Modules over HTTP; Reading the Master Trace Table
HTTPDSRV
The Display Modules over HTTP
HTTPPRB
A Security System That Accepts Any User ID; Every Login Is Refused, HTTPD042W
HTTPPRM, DD name
Configuring HTTPD
HTTPPRM, member
Which Member HTTPD Reads
HTTPPRM, member missing
The Member Is Not There
HTTPX, append-only
HTTPD Levels and the Function Vector
IBM1047
The Code Page
IDCAMS
Step 4: Scratch the Libraries
IEA703I
A Route to a Missing Module
index.html
Getting the Welcome Page; Directory Requests
install job
Editing and Submitting the Install Job; Edit and Submit the Install Job
installation
Installing HTTPD
introduction
Introducing HTTPD
keep-alive
Two Requests on One Connection; Keep-Alive and Client Time Limits
keep-alive, wait
A Response Takes Five Seconds
KEEPALIVE_MAX
Keep-Alive and Client Time Limits
KEEPALIVE_MAX, count
The Request Count of a Connection
KEEPALIVE_TIMEOUT
Keep-Alive and Client Time Limits
KEYWORD=VALUE
The Format of the Member
level
Before You Start
limits, security
What HTTPD Does Not Do
lineage
Version and Lineage
link list
Where the Module Must Be
LIST
Step 3: Read the LIST
LISTCAT
Step 6: Check That It Is Gone
LOC
Routes and Server Modules; Static Locations
LOC, route
The Two Kinds of Route
LOC=
LOC= Routes
LOGIN
Retired Keywords
login, troubleshooting
Logins
LtpaToken2
TOKEN
M, procedure symbol
Which Member HTTPD Reads
main, server module
The Entry Point
master trace table
HTTPDMTT, the Master Trace Table; Reading the Master Trace Table
MAXTASK
Worker Threads
mbt, server module
Building
mbt.toml
Building
messages, reading
Where to Look First
methods, static files
What Is Not Supported
migration
Upgrading from HTTPD 3.x
MIME types
Content Types
MINTASK
Worker Threads
MOD
Routes and Server Modules
MOD, route
The Two Kinds of Route
MOD=
MOD= Routes
MODIFY command
The Operator Commands
module, missing
A Route to a Missing Module
module, resident
Modules Held in Storage: RESIDENT
module, static data
A Module Abends with S0C4
module, storage
Storage
module, troubleshooting
A Module Does Not Run
module, writing
Writing a Server Module
monitoring
Watching a Long-Running Server
MOUNT
Mounting the Image
mvsMF
mvsMF Is Optional; The Standard Module: mvsMF
MVSMF
The Standard Module: mvsMF
not found
A File That Is Not There
operation
Operating HTTPD
operator
Operating HTTPD
P HTTPD
Stopping; Step 1: Stop the Server
package, contents
What Is in the Package
PARMLIB
The Procedure and the Parmlib Member
Parmlib member
The Parts; Configuring HTTPD
Parmlib member, format
The Format of the Member
Parmlib member, minimal
A Minimal Member
Parmlib member, production
A Production Member
password change
A Changed RACF Password and the Cached Login; A Changed Password Does Not Take Effect
path, decoding
Paths
path traversal
Paths
pattern, route
The Order of the Routes and the First Match
percent encoding
Paths
persistent connection
Two Requests on One Connection
PORT
Changing the Port
port, change
Changing the Port
port in use
The Port Is Busy
POST_STRING
Reading the Request
predecessor
What the SMP Upgrade Deletes
prerequisites
What HTTPD Needs; What You Need
problem report
What to Collect
problems
Problems at Upgrade
problems, installation
Problems at Installation
procedure
The Procedure and the Parmlib Member
program name
MOD= Routes
public paths
What Needs No Login
public route
NONE
QUERY_STRING
Reading the Request
quiesce
Long-Running Handlers
RACF
Authentication and Security
RAKF
RAKF Is Required for Logins; Authentication and Security; RES=: Checking a Profile
RAKF, users and profiles
Defining the Users and Profiles in RAKF
RAKF0001
A Security System That Accepts Any User ID; Every Login Is Refused, HTTPD042W
RAKF0002
A Security System That Accepts Any User ID
RAKF0003
A Security System That Accepts Any User ID
RAKF0004
A Security System That Accepts Any User ID; Every Login Is Refused, HTTPD042W
RAKF0009
A Security System That Accepts Any User ID
REALM
The Realm
realm
The Realm; 401, the Route Needs a Login
RECLAIM
Retired Keywords
refuse to start
Refusals
removal
Removing HTTPD
removal, procedure
Step 5: The Parts that SMP Never Owned
removal, RAKF
Step 5: The Parts that SMP Never Owned
removal, webroot
Step 5: The Parts that SMP Never Owned
request, flow
How a Request Is Handled
request trace
The Request Trace
request trace, slow request
A Request Is Slow
request variables
Reading the Request
requirements
What HTTPD Needs
RES=
RES=: Checking a Profile
RES=, 403
403, the Resource Is Denied
RES=, profile missing
Refusing a Route Whose Profile Is Missing
RES_NOPROFILE
Refusing a Route Whose Profile Is Missing
RES_NOPROFILE, wrong value
A Route Without a Valid Policy
RESIDENT
Modules Held in Storage: RESIDENT; Deploying and Routing
response, chunked
The End of the Headers
response, module
Sending the Response
response headers
Reading the Response
restart
Restarting; Restarting
retired keywords
Retired Keywords
return code
Reading the Result; Reading the Result
return code, start refused
A Start That Ends
route
The Parts
route errors
Warnings and Refusals While HTTPD Reads the Routes
routes
Routes and Server Modules
routes, shipped
What HTTPD Serves After the Install
S HTTPD,M=
Which Member HTTPD Reads
S0C4
A Module Abends with S0C4
S222
Cancelling
S806
A Module Does Not Run
sample members
After the Upgrade: Review Your Own Files
scratch
Step 4: Scratch the Libraries
SCRIPT_FILENAME
MOD= Routes
Sec-Token
FORM
Sec-Uri
FORM; 302, the Login Form
security
Authentication and Security
security system, accepts any user ID
A Security System That Accepts Any User ID
server module
The Parts; Routes and Server Modules; Writing a Server Module
server module, LINK
What a Server Module Is
server side includes
Server Side Includes
session
How Long a Login Lasts
session, stale
A Changed Password Does Not Take Effect
SESSION_MAXAGE
Sessions and the Client Time Limit; How Long a Login Lasts; A Changed Password Does Not Take Effect
SESSION_TIMEOUT
Sessions and the Client Time Limit; How Long a Login Lasts
SET MA
Worker Threads
SET MAXTASK
Changing the number of workers and the SMF level
SET MI
Worker Threads
SET MINTASK
Changing the number of workers and the SMF level
SET STATS
Recording SMF Records; Changing the number of workers and the SMF level
shutdown, module
Long-Running Handlers
SMF
Recording SMF Records
SMF, level
Recording SMF Records
SMF, operator
Recording with SMF
SMP, LIST
Step 3: Read the LIST
SMP, removal
Step 2: Cut the FMIDs out of the SMP Inventory
SMPAPP
Step 2: Cut the FMIDs out of the SMP Inventory
socket thread
How a Request Is Handled
SSI
Server Side Includes
stale credential
A Changed RACF Password and the Cached Login
start
Starting HTTPD; Starting
start, console messages
What the Console Shows
start, healthy
A healthy start
start, refused
A start that is refused; A Start That Ends
started task
The Parts
started task, start
Starting
started task identity
The Identity of the Server
static data, module
Storage
static files
Serving Files
static files, protect
LOC= Routes
static locations
Static Locations
status codes, troubleshooting
The Status Is Not 200
status line
Reading the Response
STCGROUP
The Identity of the Server
STCUSER
The Identity of the Server; The Server Has Not Its Own Identity
STEPLIB
Where the Module Must Be
STEPLIB, server module
Deploying and Routing
stop
Stopping a Running HTTPD; Stopping; Stop the Server
stop, before removal
Step 1: Stop the Server
storage key
A Module Abends with S0C4
subpool 5
Storage
SVC 244
Authorization Fails
symptoms
Troubleshooting
SYSPRINT, not allowed
The Procedure Has the Wrong DD Names
text and binary
Text, Binary and the Code Page
THTP450
What Changes for HTTPD 4.5.0
THTP450, development build
A Development Build with a Later FMID
THTP451
One Release at a Time; What Changes for HTTPD 4.5.1
time zone
The Time Zone
time-out, client
Keep-Alive and Client Time Limits; The Client Cannot Connect
time-out, diagnostic
The Diagnostic of a Client Time-out
TLS
What HTTPD Does Not Do
token
TOKEN
TOKEN, when to use
When to Use TOKEN
trace
The Trace
TRACE
The Request Trace; A Request Is Slow
Transfer-Encoding
The End of the Headers; A Response Takes Five Seconds
troubleshooting
Troubleshooting
troubleshooting, first request
What Can Go Wrong
troubleshooting, static files
What Can Go Wrong
TZOFFSET
The Time Zone; Retired Keywords
UCLIN
Step 2: Cut the FMIDs out of the SMP Inventory
UFS
Where the Files Are
UFS=0
When UFSD Is Not There
UFSD
UFSD Is Optional; Where the Files Are
UFSD, mount
Mounting the Image
UFSD, not running
When UFSD Is Not There
UFSD, troubleshooting
Static Files Are Not Served
ufsd-utils
Building a Web Root Image
uninstall
Removing HTTPD
upgrade
Upgrading HTTPD
upload, XMIT
Sending the Two XMIT Files
verification
Verifying the Install
verify
Verifying the Upgrade
verify, removal
Step 6: Check That It Is Gone
verify configuration
Reading Back What HTTPD Parsed
warnings, start
The Start Goes On, but Not as Intended
web root
The Parts
web root image
Building a Web Root Image
webroot
The Document Root Disk
welcome page
Getting the Welcome Page
wildcard
The Order of the Routes and the First Match
worker thread
How a Request Is Handled
worker threads
Worker Threads
workers, busy
Requests Wait or Workers Abend
WWW-Authenticate
BASIC; 401, the Route Needs a Login
z/OSMF
The Standard Module: mvsMF